Container Services - Get

Ottiene le proprietà del servizio contenitore specificato nella sottoscrizione e nel gruppo di risorse specificati. L'operazione restituisce le proprietà, inclusi lo stato, l'agente di orchestrazione, il numero di master e agenti e i nomi fqdn di master e agenti.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ContainerService/containerServices/{containerServiceName}?api-version=2017-01-31

Parametri dell'URI

Name In Required Type Description
containerServiceName
path True
  • string

Nome del servizio contenitore nella sottoscrizione e nel gruppo di risorse specificati.

resourceGroupName
path True
  • string

Nome del gruppo di risorse.

subscriptionId
path True
  • string

Credenziali della sottoscrizione che identificano in modo univoco Microsoft Azure sottoscrizione. L'ID sottoscrizione fa parte dell'URI per ogni chiamata di servizio.

api-version
query True
  • string

Versione API client.

Risposte

Name Type Description
200 OK

OK

Sicurezza

azure_auth

Azure Active Directory flusso OAuth2

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name Description
user_impersonation rappresentare l'account utente

Esempio

Get Container Service

Sample Request

GET https://management.azure.com/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.ContainerService/containerServices/acs1?api-version=2017-01-31

Sample Response

{
  "type": "Microsoft.ContainerService/ContainerServices",
  "location": "location1",
  "id": "/subscriptions/subid1/resourceGroups/rg1/providers/Microsoft.ContainerService/containerServices/acs1",
  "name": "acs1",
  "properties": {
    "provisioningState": "Succeeded",
    "orchestratorProfile": {
      "orchestratorType": "DCOS"
    },
    "masterProfile": {
      "count": 1,
      "dnsPrefix": "acs1-rg1-e240e5mgmt",
      "fqdn": "acs1-rg1-e240e5mgmt.location1.cloudapp.azure.com"
    },
    "agentPoolProfiles": [
      {
        "name": "agentpool0",
        "count": 3,
        "vmSize": "Standard_D2_v2",
        "dnsPrefix": "acs1-rg1-e240e5agent",
        "fqdn": "acs1-rg1-e240e5agent.location1.cloudapp.azure.com"
      }
    ],
    "linuxProfile": {
      "ssh": {
        "publicKeys": [
          {
            "keyData": "ssh-rsa AAAAB3NzaC1y...+0vNzo1FAdQ== user@hostname.local\n"
          }
        ]
      },
      "adminUsername": "azureuser"
    },
    "diagnosticsProfile": {
      "vmDiagnostics": {
        "enabled": true,
        "storageUri": "https://mjwjtrv73stvgdiag0.blob.core.windows.net/"
      }
    }
  }
}

Definizioni

ContainerService

Servizio contenitore.

ContainerServiceAgentPoolProfile

Profilo per il pool di agenti del servizio contenitore.

ContainerServiceCustomProfile

Proprietà per configurare un cluster del servizio contenitore personalizzato.

ContainerServiceDiagnosticsProfile
ContainerServiceLinuxProfile

Profilare le macchine virtuali Linux nel cluster del servizio contenitore.

ContainerServiceMasterProfile

Profilo per il master del servizio contenitore.

ContainerServiceOrchestratorProfile

Profilo per l'agente di orchestrazione del servizio contenitore.

ContainerServiceOrchestratorTypes

Agente di orchestrazione da usare per gestire le risorse del cluster del servizio contenitore. I valori validi sono Swarm, DCOS e Custom.

ContainerServiceServicePrincipalProfile

Informazioni su un'identità dell'entità servizio per il cluster da usare per la modifica delle API di Azure.

ContainerServiceSshConfiguration

Configurazione SSH per macchine virtuali basate su Linux in esecuzione in Azure.

ContainerServiceSshPublicKey

Contiene informazioni sui dati della chiave pubblica del certificato SSH.

ContainerServiceVMDiagnostics

Profilare per la diagnostica nelle macchine virtuali del servizio contenitore.

ContainerServiceVMSizeTypes

Dimensioni delle macchine virtuali dell'agente.

ContainerServiceWindowsProfile

Profilare le macchine virtuali Windows nel cluster del servizio contenitore.

ContainerService

Servizio contenitore.

Name Type Description
id
  • string

ID risorsa

location
  • string

Posizione risorsa

name
  • string

Nome risorsa

properties.agentPoolProfiles

Proprietà del pool di agenti.

properties.customProfile

Proprietà per i cluster personalizzati.

properties.diagnosticsProfile

Proprietà dell'agente di diagnostica.

properties.linuxProfile

Proprietà delle macchine virtuali Linux.

properties.masterProfile

Proprietà degli agenti master.

properties.orchestratorProfile

Proprietà dell'agente di orchestrazione.

properties.provisioningState
  • string

lo stato di distribuzione o provisioning corrente, che viene visualizzato solo nella risposta.

properties.servicePrincipalProfile

Proprietà per le entità servizio del cluster.

properties.windowsProfile

Proprietà delle macchine virtuali Windows.

tags
  • object

Tag delle risorse

type
  • string

Tipo di risorsa

ContainerServiceAgentPoolProfile

Profilo per il pool di agenti del servizio contenitore.

Name Type Description
count
  • integer

Numero di agenti (VM) per ospitare i contenitori Docker. I valori consentiti devono essere compresi tra 1 e 100 (inclusi). Il valore predefinito è 1.

dnsPrefix
  • string

Prefisso DNS da usare per creare il nome di dominio completo per il pool di agenti.

fqdn
  • string

FQDN per il pool di agenti.

name
  • string

Nome univoco del profilo del pool di agenti nel contesto della sottoscrizione e del gruppo di risorse.

vmSize

Dimensioni delle macchine virtuali dell'agente.

ContainerServiceCustomProfile

Proprietà per configurare un cluster del servizio contenitore personalizzato.

Name Type Description
orchestrator
  • string

Nome dell'agente di orchestrazione personalizzato da utilizzare.

ContainerServiceDiagnosticsProfile

Name Type Description
vmDiagnostics

Profilo per l'agente di diagnostica della macchina virtuale del servizio contenitore.

ContainerServiceLinuxProfile

Profilare le macchine virtuali Linux nel cluster del servizio contenitore.

Name Type Description
adminUsername
  • string

Nome utente dell'amministratore da usare per le macchine virtuali Linux.

ssh

Configurazione della chiave SSH per le macchine virtuali Linux.

ContainerServiceMasterProfile

Profilo per il master del servizio contenitore.

Name Type Description
count enum:
  • 1
  • 3
  • 5

Numero di master (VM) nel cluster del servizio contenitore. I valori consentiti sono 1, 3 e 5. Il valore predefinito è 1.

dnsPrefix
  • string

Prefisso DNS da usare per creare il nome di dominio completo per il master.

fqdn
  • string

FQDN per il master.

ContainerServiceOrchestratorProfile

Profilo per l'agente di orchestrazione del servizio contenitore.

Name Type Description
orchestratorType

Agente di orchestrazione da usare per gestire le risorse del cluster del servizio contenitore. I valori validi sono Swarm, DCOS e Custom.

ContainerServiceOrchestratorTypes

Agente di orchestrazione da usare per gestire le risorse del cluster del servizio contenitore. I valori validi sono Swarm, DCOS e Custom.

Name Type Description
Custom
  • string
DCOS
  • string
Kubernetes
  • string
Swarm
  • string

ContainerServiceServicePrincipalProfile

Informazioni su un'identità dell'entità servizio per il cluster da usare per la modifica delle API di Azure.

Name Type Description
clientId
  • string

ID dell'entità servizio.

secret
  • string

Password segreta associata all'entità servizio.

ContainerServiceSshConfiguration

Configurazione SSH per macchine virtuali basate su Linux in esecuzione in Azure.

Name Type Description
publicKeys

l'elenco di chiavi pubbliche SSH usate per l'autenticazione con macchine virtuali basate su Linux.

ContainerServiceSshPublicKey

Contiene informazioni sui dati della chiave pubblica del certificato SSH.

Name Type Description
keyData
  • string

Chiave pubblica del certificato usata per l'autenticazione con le macchine virtuali tramite SSH. Il certificato deve essere in formato PEM con o senza intestazioni.

ContainerServiceVMDiagnostics

Profilare per la diagnostica nelle macchine virtuali del servizio contenitore.

Name Type Description
enabled
  • boolean

Indica se viene eseguito il provisioning dell'agente di diagnostica della macchina virtuale nella macchina virtuale.

storageUri
  • string

URI dell'account di archiviazione in cui vengono archiviate le informazioni di diagnostica.

ContainerServiceVMSizeTypes

Dimensioni delle macchine virtuali dell'agente.

Name Type Description
Standard_A0
  • string
Standard_A1
  • string
Standard_A10
  • string
Standard_A11
  • string
Standard_A2
  • string
Standard_A3
  • string
Standard_A4
  • string
Standard_A5
  • string
Standard_A6
  • string
Standard_A7
  • string
Standard_A8
  • string
Standard_A9
  • string
Standard_D1
  • string
Standard_D11
  • string
Standard_D11_v2
  • string
Standard_D12
  • string
Standard_D12_v2
  • string
Standard_D13
  • string
Standard_D13_v2
  • string
Standard_D14
  • string
Standard_D14_v2
  • string
Standard_D1_v2
  • string
Standard_D2
  • string
Standard_D2_v2
  • string
Standard_D3
  • string
Standard_D3_v2
  • string
Standard_D4
  • string
Standard_D4_v2
  • string
Standard_D5_v2
  • string
Standard_DS1
  • string
Standard_DS11
  • string
Standard_DS12
  • string
Standard_DS13
  • string
Standard_DS14
  • string
Standard_DS2
  • string
Standard_DS3
  • string
Standard_DS4
  • string
Standard_G1
  • string
Standard_G2
  • string
Standard_G3
  • string
Standard_G4
  • string
Standard_G5
  • string
Standard_GS1
  • string
Standard_GS2
  • string
Standard_GS3
  • string
Standard_GS4
  • string
Standard_GS5
  • string

ContainerServiceWindowsProfile

Profilare le macchine virtuali Windows nel cluster del servizio contenitore.

Name Type Description
adminPassword
  • string

Password dell'amministratore da usare per le macchine virtuali Windows.

adminUsername
  • string

Nome utente dell'amministratore da usare per le macchine virtuali Windows.