Freigeben über


Build Service - List Build Services

Auflisten der Builddienstressource.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.AppPlatform/Spring/{serviceName}/buildServices?api-version=2023-12-01

URI-Parameter

Name In Erforderlich Typ Beschreibung
resourceGroupName
path True

string

Der Name der Ressourcengruppe, die die Ressource enthält. Dieser Wert kann über die Azure-Ressourcen-Manager-API oder das Portal abgerufen werden.

serviceName
path True

string

Der Name der Dienstressource.

RegEx-Muster: ^[a-z][a-z0-9-]*[a-z0-9]$

subscriptionId
path True

string

Ruft die Abonnement-ID ab, die das Microsoft Azure-Abonnement eindeutig identifiziert. Die Abonnement-ID ist Teil des URI für jeden Dienstaufruf.

api-version
query True

string

Hierbei handelt es sich um die für diesen Vorgang zu verwendende API-Version.

Antworten

Name Typ Beschreibung
200 OK

BuildServiceCollection

Erfolg. Die Antwort beschreibt die Builddienste.

Other Status Codes

CloudError

Fehlerantwort mit Beschreibung des Grunds für den Fehler.

Sicherheit

azure_auth

Azure Active Directory-OAuth2-Flow

Typ: oauth2
Ablauf: implicit
Autorisierungs-URL: https://login.microsoftonline.com/common/oauth2/authorize

Bereiche

Name Beschreibung
user_impersonation Identitätswechsel Ihres Benutzerkontos

Beispiele

BuildService_ListBuildServices

Beispielanforderung

GET https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/Spring/myservice/buildServices?api-version=2023-12-01

Beispiel für eine Antwort

{
  "value": [
    {
      "properties": {
        "kPackVersion": "0.3.1",
        "provisioningState": "Succeeded",
        "resourceRequests": {
          "cpu": "200m",
          "memory": "4Gi"
        }
      },
      "systemData": {
        "createdBy": "sample-user",
        "createdByType": "User",
        "createdAt": "2021-08-11T03:16:03.944Z",
        "lastModifiedBy": "sample-user",
        "lastModifiedByType": "User",
        "lastModifiedAt": "2021-08-11T03:17:03.944Z"
      },
      "type": "Microsoft.AppPlatform/Spring/buildServices",
      "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/Spring/myservice/buildServices/default",
      "name": "default"
    }
  ],
  "nextLink": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/myResourceGroup/providers/Microsoft.AppPlatform/Spring/myservice/buildServices?$page=2"
}

Definitionen

Name Beschreibung
BuildService

Erstellen von Dienstressourcennutzlast

BuildServiceCollection

Objekt, das ein Array von Builddienstressourcen und einen möglichen Link für den nächsten Satz enthält

BuildServiceProperties

Erstellen der Nutzlast der Dienstressourceneigenschaften

BuildServiceProvisioningState

Bereitstellungsstatus des KPack-Builddiensts

CloudError

Eine Fehlerantwort vom Dienst.

CloudErrorBody

Eine Fehlerantwort vom Dienst.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

ResourceRequests

Nutzlast der Bereitstellungsressourcenanforderung

SystemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

BuildService

Erstellen von Dienstressourcennutzlast

Name Typ Beschreibung
id

string

Vollqualifizierte Ressourcen-ID für die Ressource.

name

string

Der Name der Ressource.

properties

BuildServiceProperties

Eigenschaften der Buildressource

systemData

SystemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

type

string

Der Typ der Ressource.

BuildServiceCollection

Objekt, das ein Array von Builddienstressourcen und einen möglichen Link für den nächsten Satz enthält

Name Typ Beschreibung
nextLink

string

Der URL-Client sollte verwenden, um die nächste Seite abzurufen (pro serverseitigem Paging). Es ist vorerst NULL und wird für die zukünftige Verwendung hinzugefügt.

value

BuildService[]

Sammlung von Builddienstressourcen

BuildServiceProperties

Erstellen der Nutzlast der Dienstressourceneigenschaften

Name Typ Beschreibung
containerRegistry

string

Die Ressourcen-ID der Containerregistrierung, die in diesem Builddienst verwendet wird.

kPackVersion

string

Die installierte KPack-Version in diesem Builddienst.

provisioningState

BuildServiceProvisioningState

Bereitstellungsstatus des KPack-Builddiensts

resourceRequests

ResourceRequests

Die Laufzeitressourcenkonfiguration dieses Builddiensts.

BuildServiceProvisioningState

Bereitstellungsstatus des KPack-Builddiensts

Name Typ Beschreibung
Creating

string

Deleting

string

Failed

string

Succeeded

string

Updating

string

CloudError

Eine Fehlerantwort vom Dienst.

Name Typ Beschreibung
error

CloudErrorBody

Eine Fehlerantwort vom Dienst.

CloudErrorBody

Eine Fehlerantwort vom Dienst.

Name Typ Beschreibung
code

string

Ein Bezeichner für den Fehler. Codes sind unveränderlich und sollten programmgesteuert verwendet werden.

details

CloudErrorBody[]

Eine Liste mit zusätzlichen Details zum Fehler.

message

string

Eine Meldung, die den Fehler beschreibt, der für die Anzeige in einer Benutzeroberfläche geeignet sein soll.

target

string

Das Ziel des jeweiligen Fehlers. Beispiel: Der Name der -Eigenschaft im Fehler.

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

lastModifiedByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.

Name Typ Beschreibung
Application

string

Key

string

ManagedIdentity

string

User

string

ResourceRequests

Nutzlast der Bereitstellungsressourcenanforderung

Name Typ Beschreibung
cpu

string

Erforderliche CPU. 1 Kern kann durch 1 oder 1000m dargestellt werden. Dies sollte 500m oder 1 für die Ebene Basic und {500m, 1, 2, 3, 4} für den Tarif Standard sein.

memory

string

Erforderlicher Arbeitsspeicher. 1 GB kann durch 1Gi oder 1024Mi dargestellt werden. Dies sollte {512Mi, 1Gi, 2Gi} für die Ebene Basic und {512Mi, 1Gi, 2Gi, ..., 8Gi} für den Tarif Standard sein.

SystemData

Metadaten, die sich auf die Erstellung und letzte Änderung der Ressource beziehen.

Name Typ Beschreibung
createdAt

string

Der Zeitstempel der Ressourcenerstellung (UTC).

createdBy

string

Die Identität, die die Ressource erstellt hat.

createdByType

createdByType

Der Identitätstyp, der die Ressource erstellt hat.

lastModifiedAt

string

Der Zeitstempel der Ressourcenänderung (UTC).

lastModifiedBy

string

Die Identität, die die Ressource zuletzt geändert hat.

lastModifiedByType

lastModifiedByType

Der Identitätstyp, der die Ressource zuletzt geändert hat.