Adicionar propriedades personalizadas a um ficheiroStorageContainer

Namespace: microsoft.graph

Adicione propriedades personalizadas a um objeto fileStorageContainer .

Permissões

Escolha a permissão ou permissões marcadas como menos privilegiadas para esta API. Utilize uma permissão ou permissões com privilégios mais elevados apenas se a sua aplicação o exigir. Para obter detalhes sobre as permissões delegadas e de aplicação, veja Tipos de permissão. Para saber mais sobre estas permissões, veja a referência de permissões.

Tipo de permissão	Permissões com menos privilégios	Permissões com privilégios superiores
Delegado (conta corporativa ou de estudante)	FileStorageContainer.Selected	Indisponível.
Delegado (conta pessoal da Microsoft)	Sem suporte.	Sem suporte.
Application	FileStorageContainer.Selected	Indisponível.

Além das permissões do Microsoft Graph, a sua aplicação também tem de ter as permissões ou permissões necessárias ao nível do contentor para chamar esta API. Para obter detalhes sobre os tipos de contentor, veja Tipos de Contentor. Para saber mais sobre as permissões ao nível do contentor, veja Autorização do SharePoint Embedded.

Solicitação HTTP

PATCH /storage/fileStorage/containers/{containerId}/customProperties

Cabeçalhos de solicitação

Nome	Descrição
Autorização	{token} de portador. Obrigatório. Saiba mais sobre autenticação e autorização.
Content-Type	application/json. Obrigatório.

Corpo da solicitação

No corpo do pedido, forneça uma representação JSON de um fileStorageContainerCustomPropertyDictionary, que é um mapa com chaves de cadeia e valores fileStorageContainerCustomPropertyValue .

Pode especificar as seguintes propriedades quando criar uma propriedade personalizada.

Propriedade	Tipo	Descrição
value	Cadeia de caracteres	O valor da propriedade personalizada. Obrigatório.
isSearchable	Booliano	Um sinalizador para indicar se a propriedade é pesquisável. Opcional. O valor padrão é false.

Resposta

Se tiver êxito, este método retornará um código de resposta 200 Created.

Exemplos

Exemplo 1: Criar uma propriedade personalizada

Solicitação

O exemplo seguinte mostra como criar uma propriedade personalizada chamada clientUniqueId para um contentor.

HTTP

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/{containerId}/customProperties
Content-Type: application/json

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b"
  }
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const fileStorageContainerCustomPropertyDictionary = {
  clientUniqueId: {
    value: 'c5d88310-1fc7-49be-80ca-e7d7a11e638b'
  }
};

await client.api('/storage/fileStorage/containers/{containerId}/customProperties')
	.update(fileStorageContainerCustomPropertyDictionary);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

O exemplo a seguir mostra a resposta. Por predefinição, a propriedade não é pesquisável.

HTTP/1.1 200 Created

Exemplo 2: Criar uma propriedade pesquisável personalizada

Solicitação

O exemplo seguinte mostra como criar uma propriedade personalizada pesquisável chamada clientUniqueId para um contentor.

HTTP

PATCH https://graph.microsoft.com/v1.0/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties
Content-Type: application/json

{
  "clientUniqueId": {
    "value": "c5d88310-1fc7-49be-80ca-e7d7a11e638b",
    "isSearchable": true
  }
}

JavaScript

const options = {
	authProvider,
};

const client = Client.init(options);

const fileStorageContainerCustomPropertyDictionary = {
  clientUniqueId: {
    value: 'c5d88310-1fc7-49be-80ca-e7d7a11e638b',
    isSearchable: true
  }
};

await client.api('/storage/fileStorage/containers/b!ISJs1WRro0y0EWgkUYcktDa0mE8zSlFEqFzqRn70Zwp1CEtDEBZgQICPkRbil_5Z/customProperties')
	.update(fileStorageContainerCustomPropertyDictionary);

Para obter detalhes sobre como adicionar o SDK ao seu projeto e criar uma instância authProvider, consulte a documentação do SDK.

Resposta

O exemplo a seguir mostra a resposta.

HTTP/1.1 200 Created