Api Issue Attachment - Create Or Update

  • Riferimento
Service:
API Management
API Version:
2022-08-01

Crea un nuovo allegato per il problema in un'API o ne aggiorna uno esistente.

PUT https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/apis/{apiId}/issues/{issueId}/attachments/{attachmentId}?api-version=2022-08-01

Parametri dell'URI

Nome In Necessario Tipo Descrizione
apiId
 path True

string

Identificatore API. Deve essere univoco nell'istanza corrente del servizio di Gestione API.
attachmentId
 path True

string

Identificatore di allegato all'interno di un problema. Deve essere univoco nel problema corrente.

Regex pattern: ^[^*#&+:<>?]+$
issueId
 path True

string

Identificatore del problema. Deve essere univoco nell'istanza corrente del servizio di Gestione API.

Regex pattern: ^[^*#&+:<>?]+$
resourceGroupName
 path True

string

Nome del gruppo di risorse. Per il nome non viene fatta distinzione tra maiuscole e minuscole.
serviceName
 path True

string

Nome del servizio di Gestione API.

Regex pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$
subscriptionId
 path True

string

ID della sottoscrizione di destinazione.
api-version
 query True

string

Versione dell'API da usare per questa operazione.

Intestazione della richiesta

Nome Necessario Tipo Descrizione
If-Match

string

ETag dell'entità. Non obbligatorio durante la creazione di un'entità, ma necessario durante l'aggiornamento di un'entità.

Corpo della richiesta

Nome Necessario Tipo Descrizione
properties.content True

string

Un collegamento HTTP o dati binari con codifica Base64.
properties.contentFormat True

string

Se il contenuto viene fornito tramite un collegamento HTTP o il tipo MIME dei dati binari con codifica Base64 forniti nella proprietà 'content'.
properties.title True

string

Nome file in base al quale verranno salvati i dati binari.

Risposte

Nome Tipo Descrizione
200 OK

IssueAttachmentContract

Aggiornamento dell'allegato del problema dell'API

Headers

ETag: string
201 Created

IssueAttachmentContract

Aggiunta del nuovo allegato del problema dell'API

Headers

ETag: string
Other Status Codes

ErrorResponse

Risposta di errore che descrive il motivo per cui l'operazione non è riuscita.

Sicurezza

azure_auth

Flusso OAuth2 di Azure Active Directory.

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Nome Descrizione
user_impersonation rappresentare l'account utente

Esempio

ApiManagementCreateApiIssueAttachment

Sample Request

PUT https://management.azure.com/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/attachments/57d2ef278aa04f0888cba3f3?api-version=2022-08-01

{
  "properties": {
    "title": "Issue attachment.",
    "contentFormat": "image/jpeg",
    "content": "IEJhc2U2NA=="
  }
}

Sample Response

Status code:
201 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/attachments/57d2ef278aa04f0888cba3f3",
  "type": "Microsoft.ApiManagement/service/apis/issues/attachments",
  "name": "57d2ef278aa04f0888cba3f3",
  "properties": {
    "title": "Issue attachment.",
    "contentFormat": "link",
    "content": "https://.../image.jpg"
  }
}
Status code:
200 
{
  "id": "/subscriptions/subid/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/apis/57d1f7558aa04f15146d9d8a/issues/57d2ef278aa04f0ad01d6cdc/attachments/57d2ef278aa04f0888cba3f3",
  "type": "Microsoft.ApiManagement/service/apis/issues/attachments",
  "name": "57d2ef278aa04f0888cba3f3",
  "properties": {
    "title": "Issue attachment.",
    "contentFormat": "link",
    "content": "https://.../image.jpg"
  }
}

Definizioni

Nome Descrizione
ErrorFieldContract

Contratto campo di errore.
ErrorResponse

Risposta errore.
IssueAttachmentContract

Dettagli del contratto allegato del problema.

ErrorFieldContract

Contratto campo di errore.

Nome Tipo Descrizione
code

string

Codice di errore a livello di proprietà.
message

string

Rappresentazione leggibile dell'errore a livello di proprietà.
target

string

Nome della proprietà.

ErrorResponse

Risposta errore.

Nome Tipo Descrizione
error.code

string

Codice di errore definito dal servizio. Questo codice svolge la funzione di stato secondario per il codice di errore HTTP specificato nella risposta.
error.details

ErrorFieldContract[]

Elenco di campi non validi inviati nella richiesta, in caso di errore di convalida.
error.message

string

Rappresentazione leggibile dell'errore.

IssueAttachmentContract

Dettagli del contratto allegato del problema.

Nome Tipo Descrizione
id

string

ID di risorsa completo per la risorsa. Ad esempio - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name

string

nome della risorsa.
properties.content

string

Un collegamento HTTP o dati binari con codifica Base64.
properties.contentFormat

string

Se il contenuto viene fornito tramite un collegamento HTTP o il tipo MIME dei dati binari con codifica Base64 forniti nella proprietà 'content'.
properties.title

string

Nome file in base al quale verranno salvati i dati binari.
type

string

Tipo di risorsa. Ad esempio, "Microsoft.Compute/virtualMachines" o "Microsoft.Storage/storageAccounts"