Cache - Update

Serviço:

API Management

Versão da API:

2024-05-01

Atualiza os detalhes do cache especificado por seu identificador.

PATCH https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.ApiManagement/service/{serviceName}/caches/{cacheId}?api-version=2024-05-01

Parâmetros do URI

Name	Em	Necessário	Tipo	Description
cacheId	path	True	string minLength: 1 maxLength: 80 pattern: ^[^*#&+:<>?]+$	Identificador da entidade Cache. Identificador de cache (deve ser 'padrão' ou identificador de região do Azure válido).
resourceGroupName	path	True	string minLength: 1 maxLength: 90	O nome do grupo de recursos. O nome não diferencia maiúsculas de minúsculas.
serviceName	path	True	string minLength: 1 maxLength: 50 pattern: ^[a-zA-Z](?:[a-zA-Z0-9-]*[a-zA-Z0-9])?$	O nome do serviço de Gerenciamento de API.
subscriptionId	path	True	string (uuid)	A ID da assinatura de destino. O valor deve ser um UUID.
api-version	query	True	string minLength: 1	A versão da API a ser usada para esta operação.

Cabeçalho do Pedido

Name	Necessário	Tipo	Description
If-Match	True	string	ETag da Entidade. O ETag deve corresponder ao estado atual da entidade a partir da resposta do cabeçalho da solicitação GET ou deve ser * para atualização incondicional.

Corpo do Pedido

Name	Tipo	Description
properties.connectionString	string maxLength: 300	Cadeia de conexão de tempo de execução para cache
properties.description	string maxLength: 2000	Descrição do cache
properties.resourceId	string maxLength: 2000	O uri original da entidade no cache do sistema externo aponta para
properties.useFromLocation	string maxLength: 256	Identificador de local a partir do qual usar o cache (deve ser 'padrão' ou identificador de região do Azure válido)

Respostas

Name	Tipo	Description
200 OK	CacheContract	Os detalhes do cache foram atualizados com êxito. Cabeçalhos ETag: string
Other Status Codes	ErrorResponse	Resposta de erro descrevendo por que a operação falhou.

Segurança

azure_auth

Fluxo OAuth2 do Azure Ative Directory.

Tipo: oauth2
Fluxo: implicit
URL de Autorização: https://login.microsoftonline.com/common/oauth2/authorize

Âmbitos

Name	Description
user_impersonation	personificar a sua conta de utilizador

Exemplos

ApiManagementUpdateCache

Pedido de amostra

HTTP

PATCH https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/c1?api-version=2024-05-01


{
  "properties": {
    "useFromLocation": "westindia"
  }
}

Resposta da amostra

Código de estado:

200

{
  "id": "/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.ApiManagement/service/apimService1/caches/c1",
  "type": "Microsoft.ApiManagement/service/caches",
  "name": "c1",
  "properties": {
    "useFromLocation": "westindia",
    "description": "Redis cache instances in West India",
    "connectionString": "{{5f7fbca77a891a2200f3db38}}",
    "resourceId": "https://management.azure.com/subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg1/providers/Microsoft.Cache/redis/apimservice1"
  }
}

Definições

Name	Description
CacheContract	Detalhes do cache.
CacheUpdateParameters	Detalhes da atualização do cache.
ErrorAdditionalInfo	O erro de gerenciamento de recursos informações adicionais.
ErrorDetail	O detalhe do erro.
ErrorResponse	Resposta de erro

CacheContract

Object

Detalhes do cache.

Name	Tipo	Description
id	string	ID de recurso totalmente qualificado para o recurso. Ex - /subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/{resourceProviderNamespace}/{resourceType}/{resourceName}
name	string	O nome do recurso
properties.connectionString	string maxLength: 300	Cadeia de conexão de tempo de execução para cache
properties.description	string maxLength: 2000	Descrição do cache
properties.resourceId	string maxLength: 2000	O uri original da entidade no cache do sistema externo aponta para
properties.useFromLocation	string maxLength: 256	Identificador de local a partir do qual usar o cache (deve ser 'padrão' ou identificador de região do Azure válido)
type	string	O tipo do recurso. Por exemplo, "Microsoft.Compute/virtualMachines" ou "Microsoft.Storage/storageAccounts"

CacheUpdateParameters

Object

Detalhes da atualização do cache.

Name	Tipo	Description
properties.connectionString	string maxLength: 300	Cadeia de conexão de tempo de execução para cache
properties.description	string maxLength: 2000	Descrição do cache
properties.resourceId	string maxLength: 2000	O uri original da entidade no cache do sistema externo aponta para
properties.useFromLocation	string maxLength: 256	Identificador de local a partir do qual usar o cache (deve ser 'padrão' ou identificador de região do Azure válido)

ErrorAdditionalInfo

Object

O erro de gerenciamento de recursos informações adicionais.

Name	Tipo	Description
info	object	As informações adicionais.
type	string	O tipo de informação adicional.

ErrorDetail

Object

O detalhe do erro.

Name	Tipo	Description
additionalInfo	ErrorAdditionalInfo[]	O erro informações adicionais.
code	string	O código de erro.
details	ErrorDetail[]	Os detalhes do erro.
message	string	A mensagem de erro.
target	string	O destino do erro.

ErrorResponse

Object

Resposta de erro

Name	Tipo	Description
error	ErrorDetail	O objeto de erro.