Container Apps Builds - Get

Riferimento

Servizio:: Azure Container Apps

Versione API:: 2025-02-02-preview

Ottenere una risorsa di compilazione di app contenitore

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

Parametri dell'URI

Nome	In	Necessario	Tipo	Descrizione
buildName	path	True	string minLength: 2 maxLength: 64 pattern: ^[-\w\._]+$	Nome di una compilazione.
containerAppName	path	True	string pattern: ^[-\w\._]+$	Nome dell'app contenitore a cui è associata la compilazione.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nome del gruppo di risorse. Il nome è insensibile alle maiuscole e minuscole.
subscriptionId	path	True	string (uuid)	ID della sottoscrizione di destinazione. Il valore deve essere un UUID.
api-version	query	True	string minLength: 1	Versione dell'API da usare per questa operazione.

Risposte

Nome	Tipo	Descrizione
200 OK	ContainerAppsBuildResource	Operazione ARM completata correttamente.
Other Status Codes	ErrorResponse	Risposta di errore comune.

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

ContainerAppsBuilds_Get_0

Esempio di richiesta

HTTP

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

Risposta di esempio

Codice di stato:: 200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourcegroups/rg/providers/Microsoft.App/containerApps/testCapp/builds/testBuild",
  "name": "testBuild",
  "type": "Microsoft.App/containerApps/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"
            ]
          }
        }
      ]
    },
    "logStreamEndpoint": "https://foo.azurecontainerapps.dev/logstream"
  },
  "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"
  }
}

Definizioni

Nome	Descrizione
BuildProvisioningState	Stato di provisioning dell'istanza di risorsa.
BuildStatus	Stato della compilazione dopo il provisioning.
ContainerAppsBuildConfiguration	Configurazione della compilazione.
ContainerAppsBuildResource	Informazioni relative a una singola compilazione.
ContainerRegistryWithCustomImage	Registro contenitori in cui verrà caricata l'immagine finale.
createdByType	Tipo di identità che ha creato la risorsa.
EnvironmentVariable	Modello che rappresenta una variabile di ambiente.
ErrorAdditionalInfo	Informazioni aggiuntive sull'errore di gestione delle risorse.
ErrorDetail	Dettagli dell'errore.
ErrorResponse	Risposta di errore
HttpGet	Modello che rappresenta una richiesta http get.
PreBuildStep	Modello che rappresenta un passaggio di pre-compilazione.
systemData	Metadati relativi alla creazione e all'ultima modifica della risorsa.

BuildProvisioningState

Enumerazione

Stato di provisioning dell'istanza di risorsa.

Valore	Descrizione
Canceled
Creating
Deleting
Failed
Succeeded
Updating

BuildStatus

Enumerazione

Stato della compilazione dopo il provisioning.

Valore	Descrizione
Canceled
Failed
InProgress
NotStarted
Succeeded

ContainerAppsBuildConfiguration

Object

Configurazione della compilazione.

Nome	Tipo	Descrizione
baseOs	string	Sistema operativo di base usato per compilare ed eseguire l'app.
environmentVariables	EnvironmentVariable[]	L'elenco delle variabili di ambiente da passare alla compilazione, i segreti non devono essere usati nella variabile di ambiente.
platform	string	Piattaforma da usare per compilare ed eseguire l'app.
platformVersion	string	Versione della piattaforma da usare per compilare ed eseguire l'app.
preBuildSteps	PreBuildStep[]	Elenco dei passaggi da eseguire prima della compilazione.

ContainerAppsBuildResource

Object

Informazioni relative a una singola compilazione.

Nome	Tipo	Descrizione
id	string (arm-id)	ID risorsa completo per la risorsa. Ad esempio, "/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}"
name	string	Nome della risorsa
properties.buildStatus	BuildStatus	Stato della compilazione dopo il provisioning.
properties.configuration	ContainerAppsBuildConfiguration	Configurazione della compilazione.
properties.destinationContainerRegistry	ContainerRegistryWithCustomImage	Registro contenitori in cui verrà caricata l'immagine finale.
properties.logStreamEndpoint	string	Endpoint da cui è possibile trasmettere i log di compilazione.
properties.provisioningState	BuildProvisioningState	Compilare lo stato di provisioning.
systemData	systemData	Metadati di Azure Resource Manager contenenti le informazioni createdBy e modifiedBy.
type	string	Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"

ContainerRegistryWithCustomImage

Object

Registro contenitori in cui verrà caricata l'immagine finale.

Nome	Tipo	Descrizione
image	string	Nome completo che l'immagine finale deve essere caricata come, inclusi sia il nome dell'immagine che il tag.
server	string	Server di accesso del registro contenitori in cui deve essere caricata l'immagine finale. La risorsa generatore deve avere questo registro contenitori definito insieme a un'identità da usare per accedervi.

createdByType

Enumerazione

Tipo di identità che ha creato la risorsa.

Valore	Descrizione
Application
Key
ManagedIdentity
User

EnvironmentVariable

Object

Modello che rappresenta una variabile di ambiente.

Nome	Tipo	Descrizione
name	string	Nome della variabile di ambiente.
value	string	Valore della variabile di ambiente.

ErrorAdditionalInfo

Object

Informazioni aggiuntive sull'errore di gestione delle risorse.

Nome	Tipo	Descrizione
info	object	Informazioni aggiuntive.
type	string	Tipo di informazioni aggiuntive.

ErrorDetail

Object

Dettagli dell'errore.

Nome	Tipo	Descrizione
additionalInfo	ErrorAdditionalInfo[]	Informazioni aggiuntive sull'errore.
code	string	Codice di errore.
details	ErrorDetail[]	Dettagli dell'errore.
message	string	Messaggio di errore.
target	string	Destinazione dell'errore.

ErrorResponse

Object

Risposta di errore

Nome	Tipo	Descrizione
error	ErrorDetail	Oggetto error.

HttpGet

Object

Modello che rappresenta una richiesta http get.

Nome	Tipo	Descrizione
fileName	string	Nome del file in cui deve essere salvata la richiesta.
headers	string[]	Elenco di intestazioni da inviare con la richiesta.
url	string	URL per effettuare una richiesta HTTP GET.

PreBuildStep

Object

Modello che rappresenta un passaggio di pre-compilazione.

Nome	Tipo	Descrizione
description	string	Descrizione del passaggio di pre-compilazione.
httpGet	HttpGet	Richiesta http get da inviare prima della compilazione.
scripts	string[]	Elenco di comandi personalizzati da eseguire.

systemData

Object

Metadati relativi alla creazione e all'ultima modifica della risorsa.

Nome	Tipo	Descrizione
createdAt	string (date-time)	Timestamp della creazione della risorsa (UTC).
createdBy	string	Identità che ha creato la risorsa.
createdByType	createdByType	Tipo di identità che ha creato la risorsa.
lastModifiedAt	string (date-time)	Timestamp dell'ultima modifica della risorsa (UTC)
lastModifiedBy	string	Identità che ha modificato l'ultima volta la risorsa.
lastModifiedByType	createdByType	Tipo di identità che ha modificato l'ultima volta la risorsa.

Condividi tramite

Container Apps Builds - Get

Parametri dell'URI

Risposte

Sicurezza

azure_auth

Ambiti

Esempio

ContainerAppsBuilds_Get_0

Esempio di richiesta

Risposta di esempio

Definizioni

BuildProvisioningState

BuildStatus

ContainerAppsBuildConfiguration

ContainerAppsBuildResource

ContainerRegistryWithCustomImage

createdByType

EnvironmentVariable

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

HttpGet

PreBuildStep

systemData