Atualizar countriesRegionsUpdate countriesRegions

Namespace: Microsoft GraphNamespace: microsoft.graph

Importante

As APIs na /beta versão do Microsoft Graph estão sujeitas a alterações.APIs under the /beta version in Microsoft Graph are subject to change. Não há suporte para o uso dessas APIs em aplicativos de produção.Use of these APIs in production applications is not supported. Para determinar se uma API está disponível no v 1.0, use o seletor de versão .To determine whether an API is available in v1.0, use the Version selector.

Atualizar as propriedades de um objeto de país/região para o Dynamics 365 Business central.Update the properties of a country/region object for Dynamics 365 Business Central.

PermissõesPermissions

Uma das seguintes permissões é obrigatória para chamar esta API. Para saber mais, incluindo como escolher permissões, confira Permissões.One of the following permissions is required to call this API. To learn more, including how to choose permissions, see Permissions.

Tipo de permissãoPermission type Permissões (da com menos para a com mais privilégios)Permissions (from least to most privileged)
Delegado (conta corporativa ou de estudante)Delegated (work or school account) Financials.ReadWrite.AllFinancials.ReadWrite.All
Delegado (conta pessoal da MicrosoftDelegated (personal Microsoft account Sem suporte.Not supported.
AplicativoApplication Financials.ReadWrite.AllFinancials.ReadWrite.All

Solicitação HTTPHTTP request

PATCH /financials/companies/{id}/countriesRegions/{id}

Parâmetros de consulta opcionaisOptional query parameters

Este método dá suporte a Parâmetros de consulta OData para ajudar a personalizar a resposta.This method supports the OData Query Parameters to help customize the response.

Cabeçalhos de solicitaçãoRequest headers

CabeçalhoHeader ValorValue
AutorizaçãoAuthorization {token} de portador. Obrigatório.Bearer {token}. Required.
Content-TypeContent-Type application/jsonapplication/json
If-MatchIf-Match Obrigatório.Required. Quando esse cabeçalho de solicitação for incluído e a eTag fornecida não corresponder à marca atual no countriesRegions, o countriesRegions não será atualizado.When this request header is included and the eTag provided does not match the current tag on the countriesRegions, the countriesRegions will not be updated.

Corpo da solicitaçãoRequest body

No corpo da solicitação, forneça os valores para os campos relevantes que devem ser atualizados. Propriedades existentes que não estão incluídas no corpo da solicitação terão seus valores anteriores mantidos ou serão recalculadas com base nas alterações a outros valores de propriedade. Para obter melhor desempenho, não inclua valores existentes que não foram alterados.In the request body, supply the values for relevant fields that should be updated. Existing properties that are not included in the request body will maintain their previous values or be recalculated based on changes to other property values. For best performance you shouldn't include existing values that haven't changed.

RespostaResponse

Se tiver êxito, este método retornará um 200 OK código de resposta e um objeto countriesRegions atualizado no corpo da resposta.If successful, this method returns a 200 OK response code and an updated countriesRegions object in the response body.

ExemploExample

SolicitaçãoRequest

Este é um exemplo da solicitação.Here is an example of the request.

PATCH https://graph.microsoft.com/beta/financials/companies/{id}/countriesRegions/{id}
Content-type: application/json

{
  "displayName": "United States of America"
}

RespostaResponse

Veja a seguir um exemplo da resposta.Here is an example of the response.

Observação: o objeto de resposta mostrado aqui pode ser encurtado com fins de legibilidade.Note: The response object shown here might be shortened for readability. Todas as propriedades serão retornadas de uma chamada real.All the properties will be returned from an actual call.

HTTP/1.1 200 OK
Content-type: application/json

{
  "id": "id-value",
  "code": "US",
  "displayName": "United States of America",
  "addressFormat": "City+County+Post Code",
  "lastModifiedDateTime": "2017-03-16T15:22:31.753Z"
}