Freigeben über


Microsoft.ApiManagement service/apis/schemas 2021-04-01-preview

Bicep-Ressourcendefinition

Der Ressourcentyp service/apis/schemas kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ApiManagement/service/apis/schemas-Ressource zu erstellen, fügen Sie der Vorlage den folgenden Bicep hinzu.

resource symbolicname 'Microsoft.ApiManagement/service/apis/schemas@2021-04-01-preview' = {
  name: 'string'
  parent: resourceSymbolicName
  properties: {
    contentType: 'string'
    document: {
      components: any()
      definitions: any()
      value: 'string'
    }
  }
}

Eigenschaftswerte

service/apis/schemas

Name BESCHREIBUNG Wert
name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in Bicep festlegen.
Zeichenfolge (erforderlich)

Zeichenlimit: 1-80

Gültige Zeichen:
Alphanumerische Zeichen und Bindestriche.

Muss mit einem Buchstaben beginnen und mit einem alphanumerischen Zeichen enden.
parent In Bicep können Sie die übergeordnete Ressource für eine untergeordnete Ressource angeben. Sie müssen diese Eigenschaft nur hinzufügen, wenn die untergeordnete Ressource außerhalb der übergeordneten Ressource deklariert wird.

Weitere Informationen finden Sie unter Untergeordnete Ressource außerhalb der übergeordneten Ressource.
Symbolischer Name für ressource vom Typ: apis
properties Eigenschaften des API-Schemas. ApiSchemaContractProperties

ApiSchemaContractProperties

Name BESCHREIBUNG Wert
contentType Muss ein gültiger Medientyp sein, der in einem Content-Type-Header verwendet wird, wie im RFC 2616 definiert. Medientyp des Schemadokuments (z. B. application/json, application/xml).
- Swagger Schemaverwendung application/vnd.ms-azure-apim.swagger.definitions+json
- WSDL Schemaverwendung application/vnd.ms-azure-apim.xsd+xml
- OpenApi Schemaverwendung application/vnd.oai.openapi.components+json
- WADL Schema Verwenden Sie application/vnd.ms-azure-apim.wadl.grammars+xml.
Zeichenfolge (erforderlich)
Dokument Erstellen oder Aktualisieren von Eigenschaften des API-Schemadokuments. ApiSchemaDocumentProperties

ApiSchemaDocumentProperties

Name BESCHREIBUNG Wert
components Typendefinitionen. Wird nur für Swagger/OpenAPI v2/v3-Schemas verwendet, andernfalls NULL. Für Bicep können Sie die Funktion any() verwenden.
definitions Typendefinitionen. Wird nur für Swagger/OpenAPI v1-Schemas verwendet, andernfalls null. Für Bicep können Sie die Funktion any() verwenden.
value Json-Escapezeichenfolge, die das Dokument definiert, das das Schema darstellt. Wird für andere Schemas als Swagger/OpenAPI verwendet. Zeichenfolge

Ressourcendefinition mit einer ARM-Vorlage

Der Ressourcentyp service/apis/schemas kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ApiManagement/service/apis/schemas-Ressource zu erstellen, fügen Sie der Vorlage den folgenden JSON-Code hinzu.

{
  "type": "Microsoft.ApiManagement/service/apis/schemas",
  "apiVersion": "2021-04-01-preview",
  "name": "string",
  "properties": {
    "contentType": "string",
    "document": {
      "components": {},
      "definitions": {},
      "value": "string"
    }
  }
}

Eigenschaftswerte

service/apis/schemas

Name BESCHREIBUNG Wert
type Ressourcentyp "Microsoft.ApiManagement/service/apis/schemas"
apiVersion Die Ressourcen-API-Version "2021-04-01-preview"
name Der Ressourcenname

Erfahren Sie, wie Sie Namen und Typen für untergeordnete Ressourcen in JSON-ARM-Vorlagen festlegen.
Zeichenfolge (erforderlich)

Zeichenlimit: 1-80

Gültige Zeichen:
Alphanumerische Zeichen und Bindestriche.

Muss mit einem Buchstaben beginnen und mit einem alphanumerischen Zeichen enden.
properties Eigenschaften des API-Schemas. ApiSchemaContractProperties

ApiSchemaContractProperties

Name BESCHREIBUNG Wert
contentType Muss ein gültiger Medientyp sein, der in einem Content-Type-Header verwendet wird, wie im RFC 2616 definiert. Medientyp des Schemadokuments (z. B. application/json, application/xml).
- Swagger Schemaverwendung application/vnd.ms-azure-apim.swagger.definitions+json
- WSDL Schemaverwendung application/vnd.ms-azure-apim.xsd+xml
- OpenApi Schemaverwendung application/vnd.oai.openapi.components+json
- WADL Schema Verwenden Sie application/vnd.ms-azure-apim.wadl.grammars+xml.
Zeichenfolge (erforderlich)
Dokument Erstellen oder Aktualisieren von Eigenschaften des API-Schemadokuments. ApiSchemaDocumentProperties

ApiSchemaDocumentProperties

Name BESCHREIBUNG Wert
components Typendefinitionen. Wird nur für Swagger/OpenAPI v2/v3-Schemas verwendet, andernfalls NULL.
definitions Typendefinitionen. Wird nur für Swagger/OpenAPI v1-Schemas verwendet, andernfalls null.
value Json-Escapezeichenfolge, die das Dokument definiert, das das Schema darstellt. Wird für andere Schemas als Swagger/OpenAPI verwendet. Zeichenfolge

Terraform (AzAPI-Anbieter) Ressourcendefinition

Der Ressourcentyp service/apis/schemas kann mit Vorgängen bereitgestellt werden, die Folgendes zum Ziel haben:

  • Ressourcengruppen

Eine Liste der geänderten Eigenschaften in jeder API-Version finden Sie unter Änderungsprotokoll.

Ressourcenformat

Um eine Microsoft.ApiManagement/service/apis/schemas-Ressource zu erstellen, fügen Sie Der Vorlage die folgende Terraform-Ressource hinzu.

resource "azapi_resource" "symbolicname" {
  type = "Microsoft.ApiManagement/service/apis/schemas@2021-04-01-preview"
  name = "string"
  parent_id = "string"
  body = jsonencode({
    properties = {
      contentType = "string"
      document = {
        value = "string"
      }
    }
  })
}

Eigenschaftswerte

service/apis/schemas

Name BESCHREIBUNG Wert
type Ressourcentyp "Microsoft.ApiManagement/service/apis/schemas@2021-04-01-preview"
name Der Ressourcenname Zeichenfolge (erforderlich)

Zeichenlimit: 1-80

Gültige Zeichen:
Alphanumerische Zeichen und Bindestriche.

Muss mit einem Buchstaben beginnen und mit einem alphanumerischen Zeichen enden.
parent_id Die ID der Ressource, die die übergeordnete Ressource für diese Ressource ist. ID für Ressource vom Typ: apis
properties Eigenschaften des API-Schemas. ApiSchemaContractProperties

ApiSchemaContractProperties

Name BESCHREIBUNG Wert
contentType Muss ein gültiger Medientyp sein, der in einem Content-Type-Header verwendet wird, wie im RFC 2616 definiert. Medientyp des Schemadokuments (z. B. application/json, application/xml).
- Swagger Schemaverwendung application/vnd.ms-azure-apim.swagger.definitions+json
- WSDL Schemaverwendung application/vnd.ms-azure-apim.xsd+xml
- OpenApi Schemaverwendung application/vnd.oai.openapi.components+json
- WADL Schema Verwenden Sie application/vnd.ms-azure-apim.wadl.grammars+xml.
Zeichenfolge (erforderlich)
Dokument Erstellen oder Aktualisieren von Eigenschaften des API-Schemadokuments. ApiSchemaDocumentProperties

ApiSchemaDocumentProperties

Name BESCHREIBUNG Wert
components Typendefinitionen. Wird nur für Swagger/OpenAPI v2/v3-Schemas verwendet, andernfalls NULL.
definitions Typendefinitionen. Wird nur für Swagger/OpenAPI v1-Schemas verwendet, andernfalls null.
value Json-Escapezeichenfolge, die das Dokument definiert, das das Schema darstellt. Wird für andere Schemas als Swagger/OpenAPI verwendet. Zeichenfolge