Managed Clusters - List Guardrails Versions

Service:

AKS

Version d'API:

2025-05-02-preview

Obtient la liste des versions de garde-fous prises en charge dans l’abonnement et l’emplacement spécifiés.
Contient la liste des versions de Guardrails ainsi que ses informations de prise en charge et indique s’il s’agit d’une version par défaut.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/locations/{location}/guardrailsVersions?api-version=2025-05-02-preview

Paramètres URI

Nom	Dans	Obligatoire	Type	Description
location	path	True	string minLength: 1	Nom de la région Azure.
subscriptionId	path	True	string (uuid)	ID de l’abonnement cible. La valeur doit être un UUID.
api-version	query	True	string minLength: 1	Version de l’API à utiliser pour cette opération.

Réponses

Nom	Type	Description
200 OK	GuardrailsAvailableVersionsList	Ok
Other Status Codes	CloudError	Réponse d’erreur décrivant pourquoi l’opération a échoué.

Sécurité

azure_auth

Flux OAuth2 Azure Active Directory

Type: oauth2
Flux: implicit
URL d’autorisation: https://login.microsoftonline.com/common/oauth2/authorize

Étendues

Nom	Description
user_impersonation	emprunter l’identité de votre compte d’utilisateur

Exemples

List Guardrails Versions

Exemple de requête

HTTP

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/locations/location1/guardrailsVersions?api-version=2025-05-02-preview

Exemple de réponse

Code d’état:

200

{
  "value": [
    {
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/providers/Microsoft.ContainerService/locations/location1/guardrailsVersions/v1.0.0",
      "type": "Microsoft.ContainerService/locations/guardrailsVersions",
      "name": "v1.0.0",
      "properties": {
        "isDefaultVersion": true,
        "support": "Preview"
      }
    }
  ]
}

Définitions

Nom	Description
CloudError	Réponse d’erreur du service Conteneur.
CloudErrorBody	Réponse d’erreur du service Conteneur.
createdByType	Type d’identité qui a créé la ressource.
GuardrailsAvailableVersion	Version disponible des garde-fous
GuardrailsAvailableVersionsList	Conserver les propriétés des valeurs, qui est un tableau de GuardrailsVersions
GuardrailsAvailableVersionsProperties	Indique si la version est par défaut ou non et les informations de prise en charge.
GuardrailsSupport	Indique si la version est en préversion ou stable.
systemData	Métadonnées relatives à la création et à la dernière modification de la ressource.

CloudError

Object

Réponse d’erreur du service Conteneur.

Nom	Type	Description
error	CloudErrorBody	Détails sur l’erreur.

CloudErrorBody

Object

Réponse d’erreur du service Conteneur.

Nom	Type	Description
code	string	Identificateur de l’erreur. Les codes sont invariants et sont destinés à être consommés par programme.
details	CloudErrorBody[]	Liste des détails supplémentaires sur l’erreur.
message	string	Message décrivant l’erreur, destiné à être adapté à l’affichage dans une interface utilisateur.
target	string	Cible de l’erreur particulière. Par exemple, le nom de la propriété en erreur.

createdByType

Énumération

Type d’identité qui a créé la ressource.

Valeur	Description
Application
Key
ManagedIdentity
User

GuardrailsAvailableVersion

Object

Version disponible des garde-fous

Nom	Type	Description
id	string (arm-id)	ID de ressource complet pour la ressource. Par exemple, « /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName} »
name	string	Nom de la ressource
properties	GuardrailsAvailableVersionsProperties	Indique si la version est par défaut ou non et les informations de prise en charge.
systemData	systemData	Métadonnées Azure Resource Manager contenant les informations createdBy et modifiedBy.
type	string	Type de la ressource. Par exemple, « Microsoft.Compute/virtualMachines » ou « Microsoft.Storage/storageAccounts »

GuardrailsAvailableVersionsList

Object

Conserver les propriétés des valeurs, qui est un tableau de GuardrailsVersions

Nom	Type	Description
nextLink	string	URL permettant d’obtenir la version suivante des garde-fous disponibles.
value	GuardrailsAvailableVersion[]	Tableau de versions de garde-fous prises en charge par AKS.

GuardrailsAvailableVersionsProperties

Object

Indique si la version est par défaut ou non et les informations de prise en charge.

Nom	Type	Description
isDefaultVersion	boolean
support	GuardrailsSupport	Indique si la version est en préversion ou stable.

GuardrailsSupport

Énumération

Indique si la version est en préversion ou stable.

Valeur	Description
Preview	La version est en préversion. Il n’est pas recommandé d’utiliser des versions préliminaires sur des clusters de production critiques. La préversion peut ne pas prendre en charge tous les cas d’utilisation.
Stable	La version est stable et peut être utilisée sur des clusters de production critiques.

systemData

Object

Métadonnées relatives à la création et à la dernière modification de la ressource.

Nom	Type	Description
createdAt	string (date-time)	Horodatage de la création de ressources (UTC).
createdBy	string	Identité qui a créé la ressource.
createdByType	createdByType	Type d’identité qui a créé la ressource.
lastModifiedAt	string (date-time)	Horodatage de la dernière modification de ressource (UTC)
lastModifiedBy	string	Identité qui a modifié la ressource pour la dernière fois.
lastModifiedByType	createdByType	Type d’identité qui a modifié la ressource pour la dernière fois.