Workspace Api - Create Or Update

Odwołanie

Usługa:: API Management

Wersja interfejsu API:: 2024-05-01

Tworzy nowy lub aktualizuje istniejący określony interfejs API obszaru roboczego w wystąpieniu usługi API Management.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/workspaces/{workspaceId}/apis/{apiId}?api-version=2024-05-01

Parametry identyfikatora URI

Nazwa	W	Wymagane	Typ	Opis
apiId	path	True	string minLength: 1 maxLength: 256 pattern: ^[^*#&+:<>?]+$	Identyfikator poprawki interfejsu API. Musi być unikatowa w bieżącym wystąpieniu usługi API Management. Nieobsługiwana poprawka ma wartość ; rev=n jako sufiks, gdzie n jest numerem poprawki.
resourceGroupName	path	True	string minLength: 1 maxLength: 90	Nazwa grupy zasobów. Nazwa jest niewrażliwa na wielkość liter.
serviceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$	Nazwa usługi API Management.
subscriptionId	path	True	string (uuid)	Identyfikator subskrypcji docelowej. Wartość musi być identyfikatorem UUID.
workspaceId	path	True	string minLength: 1 maxLength: 80 pattern: ^[^*#&+:<>?]+$	Identyfikator obszaru roboczego. Musi być unikatowa w bieżącym wystąpieniu usługi API Management.
api-version	query	True	string minLength: 1	Wersja interfejsu API do użycia dla tej operacji.

Nagłówek żądania

Nazwa	Wymagane	Typ	Opis
If-Match		string	Element ETag jednostki. Nie jest to wymagane podczas tworzenia jednostki, ale wymagane podczas aktualizowania jednostki.

Treść żądania

Nazwa	Wymagane	Typ	Opis
properties.path	True	string minLength: 0 maxLength: 400	Względny adres URL jednoznacznie identyfikujący ten interfejs API i wszystkie jego ścieżki zasobów w wystąpieniu usługi API Management. Jest on dołączany do podstawowego adresu URL punktu końcowego interfejsu API określonego podczas tworzenia wystąpienia usługi w celu utworzenia publicznego adresu URL tego interfejsu API.
apiRevision		string minLength: 1 maxLength: 100	Opisuje poprawkę interfejsu API. Jeśli nie podano żadnej wartości, zostanie utworzona domyślna wersja 1
apiRevisionDescription		string maxLength: 256	Opis poprawki interfejsu API.
apiVersion		string maxLength: 100	Wskazuje identyfikator wersji interfejsu API, jeśli interfejs API jest w wersji
apiVersionDescription		string maxLength: 256	Opis wersji interfejsu API.
apiVersionSetId		string	Identyfikator zasobu powiązanego elementu ApiVersionSet.
authenticationSettings		AuthenticationSettingsContract	Kolekcja ustawień uwierzytelniania uwzględnionych w tym interfejsie API.
contact		ApiContactInformation	Informacje kontaktowe dotyczące interfejsu API.
description		string	Opis interfejsu API. Może zawierać tagi formatowania HTML.
isCurrent		boolean	Wskazuje, czy poprawka interfejsu API jest bieżącą poprawką interfejsu API.
license		ApiLicenseInformation	Informacje o licencji dla interfejsu API.
properties.apiType		SoapApiType	Typ interfejsu API do utworzenia. `http` tworzy interfejs API REST `soap` tworzy interfejs API przekazywania protokołu SOAP `websocket` tworzy interfejs API protokołu websocket `graphql` tworzy interfejs API GraphQL. Nowe typy można dodawać w przyszłości.
properties.apiVersionSet		ApiVersionSetContractDetails	Szczegóły zestawu wersji
properties.displayName		string minLength: 1 maxLength: 300	Nazwa interfejsu API. Musi mieć długość od 1 do 300 znaków.
properties.format		ContentFormat	Format zawartości, w której jest importowany interfejs API. Nowe formaty można dodawać w przyszłości
properties.protocols		Protocol[]	Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.
properties.serviceUrl		string minLength: 0 maxLength: 2000	Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
properties.sourceApiId		string	Identyfikator interfejsu API źródłowego interfejsu API.
properties.translateRequiredQueryParameters		TranslateRequiredQueryParametersConduct	Strategia tłumaczenia wymaganych parametrów zapytania na szablony. Domyślnie ma wartość "template". Możliwe wartości: "template", "query"
properties.value		string	Wartość zawartości podczas importowania interfejsu API.
properties.wsdlSelector		WsdlSelector	Kryteria ograniczania importu WSDL do podzestawu dokumentu.
subscriptionKeyParameterNames		SubscriptionKeyParameterNamesContract	Protokoły, za pośrednictwem których udostępniono interfejs API.
subscriptionRequired		boolean	Określa, czy do uzyskiwania dostępu do interfejsu API jest wymagana subskrypcja interfejsu API lub produktu.
termsOfServiceUrl		string	Adres URL warunków użytkowania usługi dla interfejsu API. MUSI być w formacie adresu URL.
type		ApiType	Typ interfejsu API.

Odpowiedzi

Nazwa	Typ	Opis
200 OK	ApiContract	Interfejs API został pomyślnie zaktualizowany. Nagłówki ETag: string location: string Azure-AsyncOperation: string
201 Created	ApiContract	Interfejs API został pomyślnie utworzony. Nagłówki ETag: string location: string Azure-AsyncOperation: string
Other Status Codes	ErrorResponse	Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Nazwa

Typ

Opis

200 OK

ApiContract

Interfejs API został pomyślnie zaktualizowany.

Nagłówki

ETag: string
location: string
Azure-AsyncOperation: string

201 Created

ApiContract

Interfejs API został pomyślnie utworzony.

Nagłówki

ETag: string
location: string
Azure-AsyncOperation: string

Other Status Codes

ErrorResponse

Odpowiedź na błąd opisująca, dlaczego operacja nie powiodła się.

Zabezpieczenia

azure_auth

Przepływ protokołu OAuth2 usługi Azure Active Directory.

Typ: oauth2
Flow: implicit
Adres URL autoryzacji: https://login.microsoftonline.com/common/oauth2/authorize

Zakresy

Nazwa	Opis
user_impersonation	personifikacja konta użytkownika

Przykłady

ApiManagementCreateWorkspaceApi

Przykładowe żądanie

HTTP

PUT https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/workspaces/wks1/apis/tempgroup?api-version=2024-05-01

{
  "properties": {
    "description": "apidescription5200",
    "authenticationSettings": {
      "oAuth2": {
        "authorizationServerId": "authorizationServerId2283",
        "scope": "oauth2scope2580"
      }
    },
    "subscriptionKeyParameterNames": {
      "header": "header4520",
      "query": "query3037"
    },
    "displayName": "apiname1463",
    "serviceUrl": "http://newechoapi.cloudapp.net/api",
    "path": "newapiPath",
    "protocols": [
      "https",
      "http"
    ]
  }
}

Przykładowa odpowiedź

Kod stanu:: 201

location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/workspaces/wks1/apis/tempgroup?api-version=2024-05-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=201
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5c730e343244df1b9cb56e85?api-version=2024-05-01

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/workspaces/wks1/apis/apiid9419",
  "type": "Microsoft.ApiManagement/service/workspaces/apis",
  "name": "apiid9419",
  "properties": {
    "displayName": "apiname1463",
    "apiRevision": "1",
    "description": "apidescription5200",
    "serviceUrl": "http://newechoapi.cloudapp.net/api",
    "path": "newapiPath",
    "protocols": [
      "http",
      "https"
    ],
    "authenticationSettings": {
      "oAuth2": {
        "authorizationServerId": "authorizationServerId2283",
        "scope": "oauth2scope2580"
      },
      "oAuth2AuthenticationSettings": [
        {
          "authorizationServerId": "authorizationServerId2283",
          "scope": "oauth2scope2580"
        }
      ]
    },
    "subscriptionKeyParameterNames": {
      "header": "header4520",
      "query": "query3037"
    },
    "isCurrent": true,
    "isOnline": true,
    "provisioningState": "InProgress"
  }
}

Kod stanu:: 200

location: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/workspaces/wks1/apis/tempgroup?api-version=2024-05-01&asyncId=5c730e343244df1b9cb56e85&asyncCode=200
Azure-AsyncOperation: https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/tenant/operationResults/5c730e343244df1b9cb56e85?api-version=2024-05-01

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/workspaces/wks1/apis/apiid9419",
  "type": "Microsoft.ApiManagement/service/workspaces/apis",
  "name": "apiid9419",
  "properties": {
    "displayName": "apiname1463",
    "apiRevision": "1",
    "description": "apidescription5200",
    "serviceUrl": "http://newechoapi.cloudapp.net/api",
    "path": "newapiPath",
    "protocols": [
      "http",
      "https"
    ],
    "authenticationSettings": {
      "oAuth2": {
        "authorizationServerId": "authorizationServerId2283",
        "scope": "oauth2scope2580"
      },
      "oAuth2AuthenticationSettings": [
        {
          "authorizationServerId": "authorizationServerId2283",
          "scope": "oauth2scope2580"
        }
      ]
    },
    "subscriptionKeyParameterNames": {
      "header": "header4520",
      "query": "query3037"
    },
    "isCurrent": true,
    "isOnline": true,
    "provisioningState": "InProgress"
  }
}

Definicje

Nazwa	Opis
ApiContactInformation	Informacje kontaktowe interfejsu API
ApiContract	Szczegóły interfejsu API.
ApiCreateOrUpdateParameter	Tworzenie lub aktualizowanie parametrów interfejsu API.
ApiLicenseInformation	Informacje o licencji interfejsu API
ApiType	Typ interfejsu API.
ApiVersionSetContractDetails	Zestaw wersji interfejsu API zawiera wspólną konfigurację zestawu wersji interfejsu API dotyczących
AuthenticationSettingsContract	Ustawienia uwierzytelniania interfejsu API.
bearerTokenSendingMethods	Jak wysłać token do serwera.
ContentFormat	Format zawartości, w której jest importowany interfejs API. Nowe formaty można dodawać w przyszłości
ErrorAdditionalInfo	Dodatkowe informacje o błędzie zarządzania zasobami.
ErrorDetail	Szczegóły błędu.
ErrorResponse	Odpowiedź na błąd
OAuth2AuthenticationSettingsContract	Szczegóły ustawień uwierzytelniania OAuth2 interfejsu API.
OpenIdAuthenticationSettingsContract	Szczegóły ustawień uwierzytelniania OAuth2 interfejsu API.
Protocol	Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.
SoapApiType	Typ interfejsu API do utworzenia. `http` tworzy interfejs API REST `soap` tworzy interfejs API przekazywania protokołu SOAP `websocket` tworzy interfejs API protokołu websocket `graphql` tworzy interfejs API GraphQL. Nowe typy można dodawać w przyszłości.
SubscriptionKeyParameterNamesContract	Szczegóły nazw parametrów klucza subskrypcji.
TranslateRequiredQueryParametersConduct	Strategia tłumaczenia wymaganych parametrów zapytania na szablony. Domyślnie ma wartość "template". Możliwe wartości: "template", "query"
versioningScheme	Wartość określająca, gdzie identyfikator wersji interfejsu API będzie znajdować się w żądaniu HTTP.
WsdlSelector	Kryteria ograniczania importu WSDL do podzestawu dokumentu.

ApiContactInformation

Objekt

Informacje kontaktowe interfejsu API

Nazwa	Typ	Opis
email	string	Adres e-mail osoby kontaktowej/organizacji. MUSI być w formacie adresu e-mail
name	string	Nazwa identyfikująca osoby kontaktowej/organizacji
url	string	Adres URL wskazujący informacje kontaktowe. MUSI być w formacie adresu URL

ApiContract

Objekt

Szczegóły interfejsu API.

Nazwa	Typ	Opis
id	string	W pełni kwalifikowany identyfikator zasobu dla zasobu. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	Nazwa zasobu
properties.apiRevision	string minLength: 1 maxLength: 100	Opisuje poprawkę interfejsu API. Jeśli nie podano żadnej wartości, zostanie utworzona domyślna wersja 1
properties.apiRevisionDescription	string maxLength: 256	Opis poprawki interfejsu API.
properties.apiVersion	string maxLength: 100	Wskazuje identyfikator wersji interfejsu API, jeśli interfejs API jest w wersji
properties.apiVersionDescription	string maxLength: 256	Opis wersji interfejsu API.
properties.apiVersionSet	ApiVersionSetContractDetails	Szczegóły zestawu wersji
properties.apiVersionSetId	string	Identyfikator zasobu powiązanego elementu ApiVersionSet.
properties.authenticationSettings	AuthenticationSettingsContract	Kolekcja ustawień uwierzytelniania uwzględnionych w tym interfejsie API.
properties.contact	ApiContactInformation	Informacje kontaktowe dotyczące interfejsu API.
properties.description	string	Opis interfejsu API. Może zawierać tagi formatowania HTML.
properties.displayName	string minLength: 1 maxLength: 300	Nazwa interfejsu API. Musi mieć długość od 1 do 300 znaków.
properties.isCurrent	boolean	Wskazuje, czy poprawka interfejsu API jest bieżącą poprawką interfejsu API.
properties.isOnline	boolean	Wskazuje, czy poprawka interfejsu API jest dostępna za pośrednictwem bramy.
properties.license	ApiLicenseInformation	Informacje o licencji dla interfejsu API.
properties.path	string minLength: 0 maxLength: 400	Względny adres URL jednoznacznie identyfikujący ten interfejs API i wszystkie jego ścieżki zasobów w wystąpieniu usługi API Management. Jest on dołączany do podstawowego adresu URL punktu końcowego interfejsu API określonego podczas tworzenia wystąpienia usługi w celu utworzenia publicznego adresu URL tego interfejsu API.
properties.protocols	Protocol[]	Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.
properties.provisioningState	string	Stan aprowizacji
properties.serviceUrl	string minLength: 0 maxLength: 2000	Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
properties.sourceApiId	string	Identyfikator interfejsu API źródłowego interfejsu API.
properties.subscriptionKeyParameterNames	SubscriptionKeyParameterNamesContract	Protokoły, za pośrednictwem których udostępniono interfejs API.
properties.subscriptionRequired	boolean	Określa, czy do uzyskiwania dostępu do interfejsu API jest wymagana subskrypcja interfejsu API lub produktu.
properties.termsOfServiceUrl	string	Adres URL warunków użytkowania usługi dla interfejsu API. MUSI być w formacie adresu URL.
properties.type	ApiType	Typ interfejsu API.
type	string	Typ zasobu. Np. "Microsoft.Compute/virtualMachines" lub "Microsoft.Storage/storageAccounts"

ApiCreateOrUpdateParameter

Objekt

Tworzenie lub aktualizowanie parametrów interfejsu API.

Nazwa	Typ	Opis
apiRevision	string minLength: 1 maxLength: 100	Opisuje poprawkę interfejsu API. Jeśli nie podano żadnej wartości, zostanie utworzona domyślna wersja 1
apiRevisionDescription	string maxLength: 256	Opis poprawki interfejsu API.
apiVersion	string maxLength: 100	Wskazuje identyfikator wersji interfejsu API, jeśli interfejs API jest w wersji
apiVersionDescription	string maxLength: 256	Opis wersji interfejsu API.
apiVersionSetId	string	Identyfikator zasobu powiązanego elementu ApiVersionSet.
authenticationSettings	AuthenticationSettingsContract	Kolekcja ustawień uwierzytelniania uwzględnionych w tym interfejsie API.
contact	ApiContactInformation	Informacje kontaktowe dotyczące interfejsu API.
description	string	Opis interfejsu API. Może zawierać tagi formatowania HTML.
isCurrent	boolean	Wskazuje, czy poprawka interfejsu API jest bieżącą poprawką interfejsu API.
isOnline	boolean	Wskazuje, czy poprawka interfejsu API jest dostępna za pośrednictwem bramy.
license	ApiLicenseInformation	Informacje o licencji dla interfejsu API.
properties.apiType	SoapApiType	Typ interfejsu API do utworzenia. `http` tworzy interfejs API REST `soap` tworzy interfejs API przekazywania protokołu SOAP `websocket` tworzy interfejs API protokołu websocket `graphql` tworzy interfejs API GraphQL. Nowe typy można dodawać w przyszłości.
properties.apiVersionSet	ApiVersionSetContractDetails	Szczegóły zestawu wersji
properties.displayName	string minLength: 1 maxLength: 300	Nazwa interfejsu API. Musi mieć długość od 1 do 300 znaków.
properties.format	ContentFormat	Format zawartości, w której jest importowany interfejs API. Nowe formaty można dodawać w przyszłości
properties.path	string minLength: 0 maxLength: 400	Względny adres URL jednoznacznie identyfikujący ten interfejs API i wszystkie jego ścieżki zasobów w wystąpieniu usługi API Management. Jest on dołączany do podstawowego adresu URL punktu końcowego interfejsu API określonego podczas tworzenia wystąpienia usługi w celu utworzenia publicznego adresu URL tego interfejsu API.
properties.protocols	Protocol[]	Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.
properties.provisioningState	string	Stan aprowizacji
properties.serviceUrl	string minLength: 0 maxLength: 2000	Bezwzględny adres URL usługi zaplecza implementowania tego interfejsu API. Długość nie może przekraczać 2000 znaków.
properties.sourceApiId	string	Identyfikator interfejsu API źródłowego interfejsu API.
properties.translateRequiredQueryParameters	TranslateRequiredQueryParametersConduct	Strategia tłumaczenia wymaganych parametrów zapytania na szablony. Domyślnie ma wartość "template". Możliwe wartości: "template", "query"
properties.value	string	Wartość zawartości podczas importowania interfejsu API.
properties.wsdlSelector	WsdlSelector	Kryteria ograniczania importu WSDL do podzestawu dokumentu.
subscriptionKeyParameterNames	SubscriptionKeyParameterNamesContract	Protokoły, za pośrednictwem których udostępniono interfejs API.
subscriptionRequired	boolean	Określa, czy do uzyskiwania dostępu do interfejsu API jest wymagana subskrypcja interfejsu API lub produktu.
termsOfServiceUrl	string	Adres URL warunków użytkowania usługi dla interfejsu API. MUSI być w formacie adresu URL.
type	ApiType	Typ interfejsu API.

ApiLicenseInformation

Objekt

Informacje o licencji interfejsu API

Nazwa	Typ	Opis
name	string	Nazwa licencji używana dla interfejsu API
url	string	Adres URL licencji używanej dla interfejsu API. MUSI być w formacie adresu URL

ApiType

Wyliczanie

Typ interfejsu API.

Wartość	Opis
graphql
grpc
http
odata
soap
websocket

ApiVersionSetContractDetails

Objekt

Zestaw wersji interfejsu API zawiera wspólną konfigurację zestawu wersji interfejsu API dotyczących

Nazwa	Typ	Opis
description	string	Opis zestawu wersji interfejsu API.
id	string	Identyfikator istniejącego zestawu wersji interfejsu API. Pomiń tę wartość, aby utworzyć nowy zestaw wersji.
name	string	Wyświetlana nazwa zestawu wersji interfejsu API.
versionHeaderName	string	Nazwa parametru nagłówka HTTP wskazująca wersję interfejsu API, jeśli parametr versioningScheme jest ustawiony na `header`.
versionQueryName	string	Nazwa parametru zapytania, który wskazuje wersję interfejsu API, jeśli ustawienie versioningScheme ma wartość `query`.
versioningScheme	versioningScheme	Wartość określająca, gdzie identyfikator wersji interfejsu API będzie znajdować się w żądaniu HTTP.

AuthenticationSettingsContract

Objekt

Ustawienia uwierzytelniania interfejsu API.

Nazwa	Typ	Opis
oAuth2	OAuth2AuthenticationSettingsContract	Ustawienia uwierzytelniania OAuth2
oAuth2AuthenticationSettings	OAuth2AuthenticationSettingsContract[]	Kolekcja ustawień uwierzytelniania OAuth2 uwzględnionych w tym interfejsie API.
openid	OpenIdAuthenticationSettingsContract	Ustawienia uwierzytelniania OpenID Connect
openidAuthenticationSettings	OpenIdAuthenticationSettingsContract[]	Kolekcja ustawień uwierzytelniania programu Open ID Connect uwzględnionych w tym interfejsie API.

bearerTokenSendingMethods

Wyliczanie

Jak wysłać token do serwera.

Wartość	Opis
authorizationHeader	Token dostępu zostanie przesłany w nagłówku autoryzacji przy użyciu schematu elementu nośnego
query	Token dostępu zostanie przesłany jako parametry zapytania.

ContentFormat

Wyliczanie

Format zawartości, w której jest importowany interfejs API. Nowe formaty można dodawać w przyszłości

Wartość	Opis
graphql-link	Punkt końcowy interfejsu API GraphQL hostowany na publicznie dostępnym adresie internetowym.
grpc	Zawartość jest śródwierszowa, a typ zawartości to plik protobuf gRPC.
grpc-link	Plik protobuf gRPC jest hostowany na publicznie dostępnym adresie internetowym.
odata	Zawartość jest wbudowana, a typ zawartości to dokument XML OData.
odata-link	Dokument metadanych OData hostowany na publicznie dostępnym adresie internetowym.
openapi	Zawartość jest wbudowana, a typ zawartości to dokument YAML w formacie OpenAPI 3.0.
openapi+json	Zawartość jest wbudowana, a typ zawartości to dokument JSON w formacie OpenAPI 3.0.
openapi+json-link	Dokument JSON interfejsu OpenAPI 3.0 jest hostowany na publicznie dostępnym adresie internetowym.
openapi-link	Dokument YAML openAPI 3.0 jest hostowany na publicznie dostępnym adresie internetowym.
swagger-json	Zawartość jest wbudowana, a typ zawartości to dokument JSON w formacie OpenAPI 2.0.
swagger-link-json	Dokument JSON interfejsu OpenAPI 2.0 jest hostowany na publicznie dostępnym adresie internetowym.
wadl-link-json	Dokument WADL jest hostowany na publicznie dostępnym adresie internetowym.
wadl-xml	Zawartość jest wbudowana, a typ zawartości to dokument WADL.
wsdl	Zawartość jest śródwierszowa, a dokument jest dokumentem WSDL/Soap.
wsdl-link	Dokument WSDL jest hostowany na publicznie dostępnym adresie internetowym.

ErrorAdditionalInfo

Objekt

Dodatkowe informacje o błędzie zarządzania zasobami.

Nazwa	Typ	Opis
info	object	Dodatkowe informacje.
type	string	Dodatkowy typ informacji.

ErrorDetail

Objekt

Szczegóły błędu.

Nazwa	Typ	Opis
additionalInfo	ErrorAdditionalInfo[]	Dodatkowe informacje o błędzie.
code	string	Kod błędu.
details	ErrorDetail[]	Szczegóły błędu.
message	string	Komunikat o błędzie.
target	string	Element docelowy błędu.

ErrorResponse

Objekt

Odpowiedź na błąd

Nazwa	Typ	Opis
error	ErrorDetail	Obiekt błędu.

OAuth2AuthenticationSettingsContract

Objekt

Szczegóły ustawień uwierzytelniania OAuth2 interfejsu API.

Nazwa	Typ	Opis
authorizationServerId	string	Identyfikator serwera autoryzacji OAuth.
scope	string	zakres operacji.

OpenIdAuthenticationSettingsContract

Objekt

Szczegóły ustawień uwierzytelniania OAuth2 interfejsu API.

Nazwa	Typ	Opis
bearerTokenSendingMethods	bearerTokenSendingMethods[]	Jak wysłać token do serwera.
openidProviderId	string	Identyfikator serwera autoryzacji OAuth.

Protocol

Wyliczanie

Opisuje, które protokoły mogą być wywoływane operacje w tym interfejsie API.

Wartość	Opis
http
https
ws
wss

SoapApiType

Wyliczanie

Typ interfejsu API do utworzenia.

http tworzy interfejs API REST
soap tworzy interfejs API przekazywania protokołu SOAP
websocket tworzy interfejs API protokołu websocket
graphql tworzy interfejs API GraphQL. Nowe typy można dodawać w przyszłości.

Wartość	Opis
graphql	Importuje interfejs API z frontonem GraphQL.
grpc	Importuje interfejs API z frontonem gRPC.
http	Importuje interfejs API protokołu SOAP z frontonem RESTful.
odata	Importuje interfejs API z frontonem OData.
soap	Importuje interfejs API protokołu SOAP z frontonem protokołu SOAP.
websocket	Importuje interfejs API z frontonem protokołu Websocket.

SubscriptionKeyParameterNamesContract

Objekt

Szczegóły nazw parametrów klucza subskrypcji.

Nazwa	Typ	Opis
header	string	Nazwa nagłówka klucza subskrypcji.
query	string	Nazwa parametru ciągu zapytania klucza subskrypcji.

TranslateRequiredQueryParametersConduct

Wyliczanie

Strategia tłumaczenia wymaganych parametrów zapytania na szablony. Domyślnie ma wartość "template". Możliwe wartości: "template", "query"

Wartość	Opis
query	Pozostawia wymagane parametry zapytania, ponieważ są (bez tłumaczenia).
template	Tłumaczy wymagane parametry zapytania na szablony. Jest wartością domyślną

versioningScheme

Wyliczanie

Wartość określająca, gdzie identyfikator wersji interfejsu API będzie znajdować się w żądaniu HTTP.

Wartość	Opis
Header	Wersja interfejsu API jest przekazywana w nagłówku HTTP.
Query	Wersja interfejsu API jest przekazywana w parametrze zapytania.
Segment	Wersja interfejsu API jest przekazywana w segmencie ścieżki.

WsdlSelector

Objekt

Kryteria ograniczania importu WSDL do podzestawu dokumentu.

Nazwa	Typ	Opis
wsdlEndpointName	string	Nazwa punktu końcowego (portu) do zaimportowania z WSDL
wsdlServiceName	string	Nazwa usługi do zaimportowania z WSDL

Udostępnij za pośrednictwem

Workspace Api - Create Or Update

Parametry identyfikatora URI

Nagłówek żądania

Treść żądania

Odpowiedzi

Zabezpieczenia

azure_auth

Zakresy

Przykłady

ApiManagementCreateWorkspaceApi

Przykładowe żądanie

Przykładowa odpowiedź

Definicje

ApiContactInformation

ApiContract

ApiCreateOrUpdateParameter

ApiLicenseInformation

ApiType

ApiVersionSetContractDetails

AuthenticationSettingsContract

bearerTokenSendingMethods

ContentFormat

ErrorAdditionalInfo

ErrorDetail

ErrorResponse

OAuth2AuthenticationSettingsContract

OpenIdAuthenticationSettingsContract

Protocol

SoapApiType

SubscriptionKeyParameterNamesContract

TranslateRequiredQueryParametersConduct

versioningScheme

WsdlSelector

Dodatkowe zasoby