Kube Environments - Create Or Update

Descrição para Criar ou atualizar um Ambiente Kubernetes.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.Web/kubeEnvironments/{name}?api-version=2022-03-01

Parâmetros do URI

Name In Required Type Description
name
path True
  • string

Nome do Ambiente Kubernetes.

resourceGroupName
path True
  • string

Nome do grupo de recursos a que pertence o recurso.

Regex pattern: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True
  • string

O seu ID de subscrição do Azure. Trata-se de uma corda formatada pelo GUID (por exemplo, 0000000-0000-0000-0000-0000-0000000000000000000).

api-version
query True
  • string

Versão da API

Corpo do Pedido

Name Required Type Description
location True
  • string

Localização de Recursos.

extendedLocation

Localização estendida.

kind
  • string

Tipo de recurso.

properties.aksResourceID
  • string
properties.appLogsConfiguration

Configuração de cluster que permite ao daemon de log exportar registos de aplicações para um destino. Atualmente apenas "log-analytics" é suportado

properties.arcConfiguration

Configuração do cluster que determina os tipos de componentes de cluster ARC. Por exemplo: Escolher entre o tipo BuildService, FrontEnd Service ArtifactsTorageType etc.

properties.containerAppsConfiguration

Configuração do cluster para ambientes de aplicativos de contentores para configurar chave de instrumentação da Dapr e configuração VNET

properties.environmentType
  • string

Tipo de Ambiente Kubernetes. Suportado apenas para Ambientes de Aplicação de Contentores com valor como Gerido

properties.internalLoadBalancerEnabled
  • boolean

Apenas visível dentro da Vnet/Subnet

properties.staticIp
  • string

IP estático do KubeEnvironment

tags
  • object

Etiquetas de recursos.

Respostas

Name Type Description
200 OK

OK

201 Created

Criado

Other Status Codes

Serviço de Aplicações resposta de erro.

Segurança

azure_auth

Azure Ative Directory OAuth2 Flow

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

Scopes

Name Description
user_impersonation personificar a sua conta de utilizador

Exemplos

Create kube environments

Sample Request

PUT https://management.azure.com/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv?api-version=2022-03-01

{
  "location": "East US",
  "properties": {
    "staticIp": "1.2.3.4"
  }
}

Sample Response

{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv",
  "name": "testkubeenv",
  "type": "Microsoft.Web/kubeEnvironments",
  "location": "East US",
  "extendedLocation": {
    "name": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation",
    "type": "customLocation"
  },
  "tags": {},
  "properties": {
    "provisioningState": "Succeeded",
    "deploymentErrors": null,
    "internalLoadBalancerEnabled": false,
    "defaultDomain": "testkubeenv.k4apps.io",
    "staticIp": "1.2.3.4",
    "arcConfiguration": null,
    "appLogsConfiguration": null,
    "aksResourceID": "test"
  }
}
{
  "id": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.Web/kubeEnvironments/testkubeenv",
  "name": "testkubeenv",
  "type": "Microsoft.Web/kubeEnvironments",
  "location": "East US",
  "extendedLocation": {
    "name": "/subscriptions/34adfa4f-cedf-4dc0-ba29-b6d1a69ab345/resourceGroups/examplerg/providers/Microsoft.ExtendedLocation/customLocations/testcustomlocation",
    "type": "customLocation"
  },
  "tags": {},
  "properties": {
    "provisioningState": "InitializationInProgress",
    "deploymentErrors": null,
    "internalLoadBalancerEnabled": false,
    "defaultDomain": "testkubeenv.k4apps.io",
    "staticIp": "1.2.3.4",
    "arcConfiguration": null,
    "appLogsConfiguration": null,
    "aksResourceID": "test"
  }
}

Definições

AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
DefaultErrorResponse

Serviço de Aplicações resposta de erro.

Details
Error

Modelo de erro.

ExtendedLocation

Localização estendida.

FrontEndConfiguration
FrontEndServiceType
KubeEnvironment

Um cluster Kubernetes especializado para cargas de trabalho web por Serviço de Aplicações do Azure

KubeEnvironmentProvisioningState

Estado de provisionamento do Ambiente Kubernetes.

LogAnalyticsConfiguration
StorageType

AppLogsConfiguration

Name Type Description
destination
  • string
logAnalyticsConfiguration

ArcConfiguration

Name Type Description
artifactStorageAccessMode
  • string
artifactStorageClassName
  • string
artifactStorageMountPath
  • string
artifactStorageNodeName
  • string
artifactsStorageType
frontEndServiceConfiguration
kubeConfig
  • string

ContainerAppsConfiguration

Name Type Description
appSubnetResourceId
  • string

Identificação de recursos de uma sub-rede para componentes de infraestrutura de planos de controlo. Esta sub-rede deve estar no mesmo VNET que a sub-rede definida na appSubnetResourceId. Não deve sobrepor-se à gama IP definida na plataformaReservedCidr, se definido.

controlPlaneSubnetResourceId
  • string

Identificação de recursos de uma sub-rede para componentes de infraestrutura de planos de controlo. Esta sub-rede deve estar no mesmo VNET que a sub-rede definida na appSubnetResourceId. Não deve sobrepor-se à gama IP definida na plataformaReservedCidr, se definido.

daprAIInstrumentationKey
  • string

Chave de instrumentação do Monitor Azure utilizada pela Dapr para exportar serviço para telemetria de comunicação de serviço

dockerBridgeCidr
  • string

Gama IP de notação CIDR atribuída à rede de ponte Docker. Não deve sobrepor-se a quaisquer gamas IP da Subnet ou ao intervalo IP definido na plataformaReservedCidr, se definido.

platformReservedCidr
  • string

Gama IP na notação CIDR que pode ser reservada para endereços IP de infraestrutura ambiental. Não deve sobrepor-se a quaisquer outros intervalos IP da Sub-rede.

platformReservedDnsIP
  • string

Um endereço IP a partir do intervalo IP definido pela plataformaReservedCidr que será reservado para o servidor DNS interno

DefaultErrorResponse

Serviço de Aplicações resposta de erro.

Name Type Description
error

Modelo de erro.

Details

Name Type Description
code
  • string

Cadeia padronizada para identificar programáticamente o erro.

message
  • string

Descrição detalhada do erro e depuragem de informação.

target
  • string

Descrição detalhada do erro e depuragem de informação.

Error

Modelo de erro.

Name Type Description
code
  • string

Cadeia padronizada para identificar programáticamente o erro.

details

Erros detalhados.

innererror
  • string

Mais informações para depurar erro.

message
  • string

Descrição detalhada do erro e depuragem de informação.

target
  • string

Descrição detalhada do erro e depuragem de informação.

ExtendedLocation

Localização estendida.

Name Type Description
name
  • string

Nome da localização estendida.

type
  • string

Tipo de localização estendida.

FrontEndConfiguration

Name Type Description
kind

FrontEndServiceType

Name Type Description
LoadBalancer
  • string
NodePort
  • string

KubeEnvironment

Um cluster Kubernetes especializado para cargas de trabalho web por Serviço de Aplicações do Azure

Name Type Description
extendedLocation

Localização estendida.

id
  • string

Identificação de recursos.

kind
  • string

Tipo de recurso.

location
  • string

Localização de Recursos.

name
  • string

Nome de recurso.

properties.aksResourceID
  • string
properties.appLogsConfiguration

Configuração de cluster que permite ao daemon de log exportar registos de aplicações para um destino. Atualmente apenas "log-analytics" é suportado

properties.arcConfiguration

Configuração do cluster que determina os tipos de componentes de cluster ARC. Por exemplo: Escolher entre o tipo BuildService, FrontEnd Service ArtifactsTorageType etc.

properties.containerAppsConfiguration

Configuração do cluster para ambientes de aplicativos de contentores para configurar chave de instrumentação da Dapr e configuração VNET

properties.defaultDomain
  • string

Nome de domínio predefinido para o cluster

properties.deploymentErrors
  • string

Quaisquer erros ocorridos durante a validação de implantação ou implantação

properties.environmentType
  • string

Tipo de Ambiente Kubernetes. Suportado apenas para Ambientes de Aplicação de Contentores com valor como Gerido

properties.internalLoadBalancerEnabled
  • boolean

Apenas visível dentro da Vnet/Subnet

properties.provisioningState

Estado de provisionamento do Ambiente Kubernetes.

properties.staticIp
  • string

IP estático do KubeEnvironment

tags
  • object

Etiquetas de recursos.

type
  • string

Tipo de recurso.

KubeEnvironmentProvisioningState

Estado de provisionamento do Ambiente Kubernetes.

Name Type Description
Canceled
  • string
Failed
  • string
InfrastructureSetupComplete
  • string
InfrastructureSetupInProgress
  • string
InitializationInProgress
  • string
ScheduledForDelete
  • string
Succeeded
  • string
UpgradeFailed
  • string
UpgradeRequested
  • string
Waiting
  • string

LogAnalyticsConfiguration

Name Type Description
customerId
  • string
sharedKey
  • string

StorageType

Name Type Description
LocalNode
  • string
NetworkFileSystem
  • string