Partilhar via


Kube Environments - Create Or Update

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

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

Parâmetros do URI

Name Em Necessário Tipo Description
name
path True

string

Nome do Ambiente do Kubernetes.

resourceGroupName
path True

string

Nome do grupo de recursos ao qual o recurso pertence.

Padrão Regex: ^[-\w\._\(\)]+[^\.]$

subscriptionId
path True

string

O seu ID de subscrição do Azure. Esta é uma cadeia formatada por GUID (por exemplo, 0000000000-0000-0000-0000-00000000000000).

api-version
query True

string

Versão da API

Corpo do Pedido

Name Necessário Tipo Description
location True

string

Localização do Recurso.

extendedLocation

ExtendedLocation

Localização Expandida.

kind

string

Tipo de recurso.

properties.aksResourceID

string

properties.appLogsConfiguration

AppLogsConfiguration

Configuração do cluster que permite ao daemon de registo exportar registos de aplicações para um destino. Atualmente, apenas é suportada a "análise de registos"

properties.arcConfiguration

ArcConfiguration

Configuração do cluster que determina os tipos de componentes do cluster ARC. Por exemplo: escolher entre BuildService kind, FrontEnd Service ArtifactsStorageType, etc.

properties.containerAppsConfiguration

ContainerAppsConfiguration

Configuração do cluster para Ambientes de Container Apps para configurar a Chave de Instrumentação da Dapr e a Configuração da VNET

properties.environmentType

string

Tipo de Ambiente do Kubernetes. Apenas suportado para Ambientes de Aplicação de Contentor com valor como Gerido

properties.internalLoadBalancerEnabled

boolean

Apenas visível na Vnet/Sub-rede

properties.staticIp

string

IP estático do KubeEnvironment

tags

object

Etiquetas de recursos.

Respostas

Name Tipo Description
200 OK

KubeEnvironment

OK

201 Created

KubeEnvironment

Criado

Other Status Codes

DefaultErrorResponse

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

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name Description
user_impersonation representar a sua conta de utilizador

Exemplos

Create kube environments

Pedido de amostra

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

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

Resposta da amostra

{
  "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

Name Description
AppLogsConfiguration
ArcConfiguration
ContainerAppsConfiguration
DefaultErrorResponse

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

Details
Error

Modelo de erro.

ExtendedLocation

Localização Expandida.

FrontEndConfiguration
FrontEndServiceType
KubeEnvironment

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

KubeEnvironmentProvisioningState

Estado de aprovisionamento do Ambiente do Kubernetes.

LogAnalyticsConfiguration
StorageType

AppLogsConfiguration

Name Tipo Description
destination

string

logAnalyticsConfiguration

LogAnalyticsConfiguration

ArcConfiguration

Name Tipo Description
artifactStorageAccessMode

string

artifactStorageClassName

string

artifactStorageMountPath

string

artifactStorageNodeName

string

artifactsStorageType

StorageType

frontEndServiceConfiguration

FrontEndConfiguration

kubeConfig

string

ContainerAppsConfiguration

Name Tipo Description
appSubnetResourceId

string

ID de recurso de uma sub-rede para componentes de infraestrutura do plano de controlo. Esta sub-rede tem de estar na mesma VNET que a sub-rede definida em appSubnetResourceId. Não pode sobrepor-se ao intervalo de IP definido na plataformaReservedCidr, se definido.

controlPlaneSubnetResourceId

string

ID de recurso de uma sub-rede para componentes de infraestrutura do plano de controlo. Esta sub-rede tem de estar na mesma VNET que a sub-rede definida em appSubnetResourceId. Não pode sobrepor-se ao intervalo de IP definido na plataformaReservedCidr, se definido.

daprAIInstrumentationKey

string

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

dockerBridgeCidr

string

Intervalo DE IP de notação CIDR atribuído à rede de bridge do Docker. Não pode sobrepor-se a intervalos de IP de Sub-rede ou ao intervalo de IP definido na plataformaReservedCidr, se definido.

platformReservedCidr

string

Intervalo de IP na notação CIDR que pode ser reservado para endereços IP de infraestrutura de ambiente. Não pode sobrepor-se a outros intervalos de IP da Sub-rede.

platformReservedDnsIP

string

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

DefaultErrorResponse

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

Name Tipo Description
error

Error

Modelo de erro.

Details

Name Tipo Description
code

string

Cadeia padronizada para identificar programaticamente o erro.

message

string

Descrição detalhada do erro e informações de depuração.

target

string

Descrição detalhada do erro e informações de depuração.

Error

Modelo de erro.

Name Tipo Description
code

string

Cadeia padronizada para identificar programaticamente o erro.

details

Details[]

Erros detalhados.

innererror

string

Mais informações para depurar o erro.

message

string

Descrição detalhada do erro e informações de depuração.

target

string

Descrição detalhada do erro e informações de depuração.

ExtendedLocation

Localização Expandida.

Name Tipo Description
name

string

Nome da localização expandida.

type

string

Tipo de localização expandida.

FrontEndConfiguration

Name Tipo Description
kind

FrontEndServiceType

FrontEndServiceType

Name Tipo Description
LoadBalancer

string

NodePort

string

KubeEnvironment

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

Name Tipo Description
extendedLocation

ExtendedLocation

Localização Expandida.

id

string

ID do Recurso.

kind

string

Tipo de recurso.

location

string

Localização do Recurso.

name

string

Nome do Recurso.

properties.aksResourceID

string

properties.appLogsConfiguration

AppLogsConfiguration

Configuração do cluster que permite ao daemon de registo exportar registos de aplicações para um destino. Atualmente, apenas é suportada a "análise de registos"

properties.arcConfiguration

ArcConfiguration

Configuração do cluster que determina os tipos de componentes do cluster ARC. Por exemplo: escolher entre BuildService kind, FrontEnd Service ArtifactsStorageType, etc.

properties.containerAppsConfiguration

ContainerAppsConfiguration

Configuração do cluster para Ambientes de Container Apps para configurar a Chave de Instrumentação da Dapr e a Configuração da VNET

properties.defaultDomain

string

Nome de Domínio Predefinido para o cluster

properties.deploymentErrors

string

Quaisquer erros ocorridos durante a validação da implementação ou implementação

properties.environmentType

string

Tipo de Ambiente do Kubernetes. Apenas suportado para Ambientes de Aplicação de Contentor com valor como Gerido

properties.internalLoadBalancerEnabled

boolean

Apenas visível na Vnet/Sub-rede

properties.provisioningState

KubeEnvironmentProvisioningState

Estado de aprovisionamento do Ambiente do Kubernetes.

properties.staticIp

string

IP estático do KubeEnvironment

tags

object

Etiquetas de recursos.

type

string

Tipo de recurso.

KubeEnvironmentProvisioningState

Estado de aprovisionamento do Ambiente do Kubernetes.

Name Tipo Description
Canceled

string

Failed

string

InfrastructureSetupComplete

string

InfrastructureSetupInProgress

string

InitializationInProgress

string

ScheduledForDelete

string

Succeeded

string

UpgradeFailed

string

UpgradeRequested

string

Waiting

string

LogAnalyticsConfiguration

Name Tipo Description
customerId

string

sharedKey

string

StorageType

Name Tipo Description
LocalNode

string

NetworkFileSystem

string