Container Services - List Orchestrators

Servizio:

AKS

Versione API:

2019-04-01

Ottiene un elenco di agenti di orchestrazione supportati nella sottoscrizione specificata. L'operazione restituisce le proprietà di ogni agente di orchestrazione, inclusa la versione, gli aggiornamenti disponibili e se tale versione o gli aggiornamenti sono in anteprima.

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/locations/{location}/orchestrators?api-version=2019-04-01

Con parametri facoltativi:

GET https://management.azure.com/subscriptions/{subscriptionId}/providers/Microsoft.ContainerService/locations/{location}/orchestrators?api-version=2019-04-01&resource-type={resource-type}

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
location	path	True	string	Nome di un'area di Azure supportata.
subscriptionId	path	True	string	Credenziali di sottoscrizione che identificano in modo univoco la sottoscrizione di Microsoft Azure. L'ID sottoscrizione fa parte dell'URI per ogni chiamata al servizio.
api-version	query	True	string	Versione dell'API client.
resource-type	query		string	tipo di risorsa per cui deve essere restituito l'elenco di agenti di orchestrazione

Risposte

Nome	Tipo	Descrizione
200 OK	OrchestratorVersionProfileListResult	OK

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory

Tipo: oauth2
Flow: implicit
URL di autorizzazione: https://login.microsoftonline.com/common/oauth2/authorize

Ambiti

Nome	Descrizione
user_impersonation	rappresentare l'account utente

Esempio

List Container Service Orchestrators

Esempio di richiesta

HTTP

GET https://management.azure.com/subscriptions/subid1/providers/Microsoft.ContainerService/locations/location1/orchestrators?api-version=2019-04-01

Risposta di esempio

Codice di stato:

200

{
  "id": "/subscriptions/subid1/providers/Microsoft.ContainerService/locations/location1/orchestrators",
  "name": "default",
  "type": "Microsoft.ContainerService/locations/orchestrators",
  "properties": {
    "orchestrators": [
      {
        "orchestratorType": "DCOS",
        "orchestratorVersion": "1.10.0"
      },
      {
        "orchestratorType": "DCOS",
        "orchestratorVersion": "1.9.0"
      },
      {
        "orchestratorType": "DCOS",
        "orchestratorVersion": "1.8.8"
      },
      {
        "orchestratorType": "Swarm",
        "orchestratorVersion": "swarm:1.1.0"
      },
      {
        "orchestratorType": "DockerCE",
        "orchestratorVersion": "17.03.*"
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.8.1",
        "upgrades": [
          {
            "orchestratorVersion": "1.8.4"
          },
          {
            "orchestratorVersion": "1.8.2"
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.9.10",
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.9.11",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.10.12",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.10.13",
            "isPreview": false
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.9.11",
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.10.12",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.10.13",
            "isPreview": false
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.10.12",
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.10.13",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.11.8",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.11.9",
            "isPreview": false
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.10.13",
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.11.8",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.11.9",
            "isPreview": false
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.11.8",
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.11.9",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.12.6",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.12.7",
            "isPreview": false
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.11.9",
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.12.6",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.12.7",
            "isPreview": false
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.12.6",
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.12.7",
            "isPreview": false
          },
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.13.5",
            "isPreview": false
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.12.7",
        "default": true,
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.13.5",
            "isPreview": false
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.13.5",
        "upgrades": [
          {
            "orchestratorType": "",
            "orchestratorVersion": "1.14.0",
            "isPreview": true
          }
        ]
      },
      {
        "orchestratorType": "Kubernetes",
        "orchestratorVersion": "1.14.0",
        "isPreview": true
      }
    ]
  }
}

Definizioni

Nome	Descrizione
OrchestratorProfile	Elenco delle versioni di aggiornamento disponibili.
OrchestratorVersionProfile	Elenco dei profili di versione dell'agente di orchestrazione.
OrchestratorVersionProfileListResult	Elenco di versioni per gli agenti di orchestrazione supportati.

OrchestratorProfile

Object

Elenco delle versioni di aggiornamento disponibili.

Nome	Tipo	Descrizione
isPreview	boolean	Indica se la versione di Kubernetes è attualmente in anteprima.
orchestratorType	string	Tipo di agente di orchestrazione.
orchestratorVersion	string	Versione dell'agente di orchestrazione (principale, secondaria, patch).

OrchestratorVersionProfile

Object

Elenco dei profili di versione dell'agente di orchestrazione.

Nome	Tipo	Descrizione
default	boolean	Installato per impostazione predefinita se la versione non è specificata.
isPreview	boolean	Indica se la versione di Kubernetes è attualmente in anteprima.
orchestratorType	string	Tipo di agente di orchestrazione.
orchestratorVersion	string	Versione dell'agente di orchestrazione (principale, secondaria, patch).
upgrades	OrchestratorProfile[]	Elenco delle versioni di aggiornamento disponibili.

OrchestratorVersionProfileListResult

Object

Elenco di versioni per gli agenti di orchestrazione supportati.

Nome	Tipo	Descrizione
id	string	ID del risultato dell'elenco dei profili della versione dell'agente di orchestrazione.
name	string	Nome del risultato dell'elenco dei profili della versione dell'agente di orchestrazione.
properties.orchestrators	OrchestratorVersionProfile[]	Elenco dei profili di versione dell'agente di orchestrazione.
type	string	Tipo del risultato dell'elenco dei profili di versione dell'agente di orchestrazione.