Builds - Create Or Update

Referência

Serviço:: Azure Container Apps

Versão da API:: 2025-02-02-preview

Criar um BuildResource

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.App/builders/{builderName}/builds/{buildName}?api-version=2025-02-02-preview

Parâmetros de URI

Nome	Em	Obrigatório	Tipo	Description
builderName	path	True	string minLength: 2 maxLength: 32 pattern: ^[-\w\._]+$	O nome do construtor.
buildName	path	True	string minLength: 2 maxLength: 64 pattern: ^[-\w\._]+$	O nome de um build.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser uma UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Corpo da solicitação

Nome	Tipo	Description
properties.configuration	BuildConfiguration	Configuração do build.
properties.destinationContainerRegistry	ContainerRegistryWithCustomImage	Registro de contêiner para o qual a imagem final será carregada.

Respostas

Nome	Tipo	Description
200 OK	BuildResource	A operação de criação ou atualização do ARM foi concluída com êxito.
201 Created	BuildResource	A operação de criação ou atualização do ARM foi iniciada. Cabeçalhos Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Resposta de erro comum.

Nome

Tipo

Description

200 OK

BuildResource

A operação de criação ou atualização do ARM foi concluída com êxito.

201 Created

BuildResource

A operação de criação ou atualização do ARM foi iniciada.

Cabeçalhos

Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Resposta de erro comum.

Segurança

azure_auth

Fluxo OAuth2 do Azure Active Directory.

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

Escopos

Nome	Description
user_impersonation	representar sua conta de usuário

Exemplos

Builds_CreateOrUpdate_NoConfig

Builds_CreateOrUpdate_WithConfig

Builds_CreateOrUpdate_NoConfig

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.App/builders/testBuilder/builds/testBuild?api-version=2025-02-02-preview

{}

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.App/builders/testBuilder/builds/testBuild",
  "name": "testBuild",
  "type": "Microsoft.App/builders/builds",
  "properties": {
    "provisioningState": "Succeeded",
    "buildStatus": "InProgress",
    "uploadEndpoint": "https://foo.azurecontainerapps.dev/upload",
    "logStreamEndpoint": "https://foo.azurecontainerapps.dev/logstream",
    "tokenEndpoint": "https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{rg-id}/Microsoft.App/builders/testBuilder/builds/testBuild/listAuthToken"
  },
  "systemData": {
    "createdBy": "sample@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-11T11:05:51.4940669Z",
    "lastModifiedBy": "sample@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-11T11:05:51.4940669Z"
  }
}

Código de status:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.App/locations/{location}/operationStatuses/{operationId}

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.App/builders/testBuilder/builds/testBuild",
  "name": "testBuild",
  "type": "Microsoft.App/build",
  "properties": {
    "provisioningState": "Creating",
    "buildStatus": "InProgress",
    "uploadEndpoint": "https://foo.azurecontainerapps.dev/upload",
    "logStreamEndpoint": "https://foo.azurecontainerapps.dev/logstream",
    "tokenEndpoint": "https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{rg-id}/Microsoft.App/builders/testBuilder/builds/testBuild/listAuthToken"
  },
  "systemData": {
    "createdBy": "sample@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-11T11:05:51.4940669Z",
    "lastModifiedBy": "sample@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-11T11:05:51.4940669Z"
  }
}

Builds_CreateOrUpdate_WithConfig

Solicitação de exemplo

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.App/builders/testBuilder/builds/testBuild-123456789az?api-version=2025-02-02-preview

{
  "properties": {
    "destinationContainerRegistry": {
      "server": "test.azurecr.io",
      "image": "test.azurecr.io/repo:tag"
    },
    "configuration": {
      "baseOs": "DebianBullseye",
      "platform": "dotnetcore",
      "platformVersion": "7.0",
      "environmentVariables": [
        {
          "name": "foo1",
          "value": "bar1"
        },
        {
          "name": "foo2",
          "value": "bar2"
        }
      ],
      "preBuildSteps": [
        {
          "description": "First pre build step.",
          "scripts": [
            "echo 'hello'",
            "echo 'world'"
          ],
          "httpGet": {
            "url": "https://microsoft.com",
            "fileName": "output.txt",
            "headers": [
              "foo",
              "bar"
            ]
          }
        },
        {
          "description": "Second pre build step.",
          "scripts": [
            "echo 'hello'",
            "echo 'again'"
          ],
          "httpGet": {
            "url": "https://microsoft.com",
            "fileName": "output.txt",
            "headers": [
              "foo"
            ]
          }
        }
      ]
    }
  }
}

Resposta de exemplo

Código de status:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.App/builders/testBuilder/builds/testBuild-123456789az",
  "name": "testBuild-123456789az",
  "type": "Microsoft.App/builders/builds",
  "properties": {
    "provisioningState": "Succeeded",
    "buildStatus": "InProgress",
    "destinationContainerRegistry": {
      "server": "test.azurecr.io",
      "image": "test.azurecr.io/repo:tag"
    },
    "configuration": {
      "baseOs": "DebianBullseye",
      "platform": "dotnetcore",
      "platformVersion": "7.0",
      "environmentVariables": [
        {
          "name": "foo1",
          "value": "bar1"
        },
        {
          "name": "foo2",
          "value": "bar2"
        }
      ],
      "preBuildSteps": [
        {
          "description": "First pre build step.",
          "scripts": [
            "echo 'hello'",
            "echo 'world'"
          ],
          "httpGet": {
            "url": "https://microsoft.com",
            "fileName": "output.txt",
            "headers": [
              "foo",
              "bar"
            ]
          }
        },
        {
          "description": "Second pre build step.",
          "scripts": [
            "echo 'hello'",
            "echo 'again'"
          ],
          "httpGet": {
            "url": "https://microsoft.com",
            "fileName": "output.txt",
            "headers": [
              "foo"
            ]
          }
        }
      ]
    },
    "uploadEndpoint": "https://foo.azurecontainerapps.dev/upload",
    "logStreamEndpoint": "https://foo.azurecontainerapps.dev/logstream",
    "tokenEndpoint": "https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{rg-id}/Microsoft.App/builders/testBuilder/builds/testBuild/listAuthToken"
  },
  "systemData": {
    "createdBy": "sample@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-11T11:05:51.4940669Z",
    "lastModifiedBy": "sample@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-11T11:05:51.4940669Z"
  }
}

Código de status:: 201

Azure-AsyncOperation: https://management.azure.com/subscriptions/{subscription-id}/providers/Microsoft.App/locations/{location}/operationStatuses/{operationId}

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.App/builders/testBuilder/builds/testBuild",
  "name": "testBuild",
  "type": "Microsoft.App/build",
  "properties": {
    "provisioningState": "Creating",
    "buildStatus": "NotStarted",
    "destinationContainerRegistry": {
      "server": "test.azurecr.io",
      "image": "test.azurecr.io/repo:tag"
    },
    "configuration": {
      "baseOs": "DebianBullseye",
      "platform": "dotnetcore",
      "platformVersion": "7.0",
      "environmentVariables": [
        {
          "name": "foo1",
          "value": "bar1"
        },
        {
          "name": "foo2",
          "value": "bar2"
        }
      ],
      "preBuildSteps": [
        {
          "description": "First pre build step.",
          "scripts": [
            "echo 'hello'",
            "echo 'world'"
          ],
          "httpGet": {
            "url": "https://microsoft.com",
            "fileName": "output.txt",
            "headers": [
              "foo",
              "bar"
            ]
          }
        },
        {
          "description": "Second pre build step.",
          "scripts": [
            "echo 'hello'",
            "echo 'again'"
          ],
          "httpGet": {
            "url": "https://microsoft.com",
            "fileName": "output.txt",
            "headers": [
              "foo"
            ]
          }
        }
      ]
    },
    "uploadEndpoint": "https://foo.azurecontainerapps.dev/upload",
    "logStreamEndpoint": "https://foo.azurecontainerapps.dev/logstream",
    "tokenEndpoint": "https://management.azure.com/subscriptions/{subscription-id}/resourcegroups/{rg-id}/Microsoft.App/builders/testBuilder/builds/testBuild/listAuthToken"
  },
  "systemData": {
    "createdBy": "sample@microsoft.com",
    "createdByType": "User",
    "createdAt": "2022-10-11T11:05:51.4940669Z",
    "lastModifiedBy": "sample@microsoft.com",
    "lastModifiedByType": "User",
    "lastModifiedAt": "2022-10-11T11:05:51.4940669Z"
  }
}

Definições

Nome	Description
BuildConfiguration	Configuração do build.
BuildProvisioningState	Estado de provisionamento da instância de recurso.
BuildResource	Informações relativas a um build individual.
BuildStatus	Status do build depois que ele tiver sido provisionado.
ContainerRegistryWithCustomImage	Registro de contêiner para o qual a imagem final será carregada.
createdByType	O tipo de identidade que criou o recurso.
EnvironmentVariable	Modelo que representa uma variável de ambiente.
ErrorAdditionalInfo	As informações adicionais do erro de gerenciamento de recursos.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro
HttpGet	Modelo que representa uma solicitação http get.
PreBuildStep	Modelo que representa uma etapa de pré-build.
systemData	Metadados relativos à criação e última modificação do recurso.

BuildConfiguration

Objeto

Configuração do build.

Nome	Tipo	Description
baseOs	string	Sistema operacional base usado para compilar e executar o aplicativo.
environmentVariables	EnvironmentVariable[]	Lista de variáveis de ambiente a serem passadas para o build, os segredos não devem ser usados na variável de ambiente.
platform	string	Plataforma a ser usada para compilar e executar o aplicativo.
platformVersion	string	Versão da plataforma a ser usada para compilar e executar o aplicativo.
preBuildSteps	PreBuildStep[]	Lista de etapas a serem executadas antes do build.

BuildProvisioningState

Enumeração

Estado de provisionamento da instância de recurso.

Valor	Description
Canceled
Creating
Deleting
Failed
Succeeded
Updating

BuildResource

Objeto

Informações relativas a um build individual.

Nome	Tipo	Description
id	string (arm-id)	ID de recurso totalmente qualificada para o recurso. Por exemplo, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	O nome do recurso
properties.buildStatus	BuildStatus	Status do build depois que ele tiver sido provisionado.
properties.configuration	BuildConfiguration	Configuração do build.
properties.destinationContainerRegistry	ContainerRegistryWithCustomImage	Registro de contêiner para o qual a imagem final será carregada.
properties.logStreamEndpoint	string	Ponto de extremidade do qual os logs de build podem ser transmitidos.
properties.provisioningState	BuildProvisioningState	Estado de provisionamento de build.
properties.tokenEndpoint	string	Ponto de extremidade a ser usado para recuperar um token de autenticação para streaming de log e carregamento do código-fonte.
properties.uploadEndpoint	string	Ponto de extremidade para o qual o código-fonte deve ser carregado.
systemData	systemData	Metadados do Azure Resource Manager que contêm informações createdBy e modifiedBy.
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

BuildStatus

Enumeração

Status do build depois que ele tiver sido provisionado.

Valor	Description
Canceled
Failed
InProgress
NotStarted
Succeeded

ContainerRegistryWithCustomImage

Objeto

Registro de contêiner para o qual a imagem final será carregada.

Nome	Tipo	Description
image	string	Nome completo no qual a imagem final deve ser carregada, incluindo o nome da imagem e a marca.
server	string	Servidor de logon do registro de contêiner para o qual a imagem final deve ser carregada. O recurso do construtor precisa ter esse registro de contêiner definido junto com uma identidade a ser usada para acessá-lo.

createdByType

Enumeração

O tipo de identidade que criou o recurso.

Valor	Description
Application
Key
ManagedIdentity
User

EnvironmentVariable

Objeto

Modelo que representa uma variável de ambiente.

Nome	Tipo	Description
name	string	Nome da variável de ambiente.
value	string	Valor da variável de ambiente.

ErrorAdditionalInfo

Objeto

As informações adicionais do erro de gerenciamento de recursos.

Nome	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Objeto

O detalhe do erro.

Nome	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	As informações adicionais do erro.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Objeto

Resposta de erro

Nome	Tipo	Description
error	ErrorDetail	O objeto de erro.

HttpGet

Objeto

Modelo que representa uma solicitação http get.

Nome	Tipo	Description
fileName	string	Nome do arquivo no qual a solicitação deve ser salva.
headers	string[]	Lista de cabeçalhos a serem enviados com a solicitação.
url	string	URL na qual fazer solicitação HTTP GET.

PreBuildStep

Objeto

Modelo que representa uma etapa de pré-build.

Nome	Tipo	Description
description	string	Descrição da etapa de pré-compilação.
httpGet	HttpGet	Http obter solicitação para enviar antes do build.
scripts	string[]	Lista de comandos personalizados a serem executados.

systemData

Objeto

Metadados relativos à criação e última modificação do recurso.

Nome	Tipo	Description
createdAt	string (date-time)	O carimbo de data/hora da criação de recursos (UTC).
createdBy	string	A identidade que criou o recurso.
createdByType	createdByType	O tipo de identidade que criou o recurso.
lastModifiedAt	string (date-time)	O carimbo de data/hora da última modificação do recurso (UTC)
lastModifiedBy	string	A identidade que modificou o recurso pela última vez.
lastModifiedByType	createdByType	O tipo de identidade que modificou o recurso pela última vez.

Compartilhar via

Builds - Create Or Update

Parâmetros de URI

Corpo da solicitação

Respostas

Segurança

azure_auth

Escopos

Exemplos

Builds_CreateOrUpdate_NoConfig

Solicitação de exemplo

Resposta de exemplo

Builds_CreateOrUpdate_WithConfig

Solicitação de exemplo

Resposta de exemplo

Definições

BuildConfiguration

BuildProvisioningState

BuildResource

BuildStatus

ContainerRegistryWithCustomImage

createdByType

EnvironmentVariable

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HttpGet

PreBuildStep

systemData