Adición de propiedades personalizadas a un archivoStorageContainer

Espacio de nombres: microsoft.graph

Agregue propiedades personalizadas a un objeto fileStorageContainer .

Permissions

Elija el permiso o los permisos marcados como con privilegios mínimos para esta API. Use un permiso o permisos con privilegios superiores solo si la aplicación lo requiere. Para obtener más información sobre los permisos delegados y de aplicación, consulte Tipos de permisos. Para obtener más información sobre estos permisos, consulte la referencia de permisos.

Tipo de permiso	Permisos con privilegios mínimos	Permisos con privilegios más altos
Delegado (cuenta profesional o educativa)	FileStorageContainer.Selected	No disponible.
Delegado (cuenta personal de Microsoft)	No admitida.	No admitida.
Aplicación	FileStorageContainer.Selected	No disponible.

Además de los permisos de Microsoft Graph, la aplicación también debe tener los permisos o permisos de nivel de tipo de contenedor necesarios para llamar a esta API. Para obtener más información sobre los tipos de contenedor, consulte Tipos de contenedor. Para obtener más información sobre los permisos de nivel de tipo contenedor, vea Autorización de SharePoint Embedded.

Solicitud HTTP

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

Encabezados de solicitud

Nombre	Descripción
Authorization	{token} de portador. Obligatorio. Obtenga más información sobre la autenticación y la autorización.
Content-Type	application/json. Obligatorio.

Cuerpo de la solicitud

En el cuerpo de la solicitud, proporcione una representación JSON de un archivoStorageContainerCustomPropertyDictionary, que es un mapa con claves de cadena y valores fileStorageContainerCustomPropertyValue .

Puede especificar las siguientes propiedades al crear una propiedad personalizada.

Propiedad	Tipo	Descripción
value	Cadena	Valor de la propiedad personalizada. Obligatorio.
isSearchable	Booleano	Marca para indicar si la propiedad se puede buscar. Opcional. El valor predeterminado es false.

Respuesta

Si se ejecuta correctamente, este método devuelve un código de respuesta 200 Created.

Ejemplos

Ejemplo 1: Creación de una propiedad personalizada

Solicitud

En el ejemplo siguiente se muestra cómo crear una propiedad personalizada llamada clientUniqueId para un contenedor.

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 obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

En el ejemplo siguiente se muestra la respuesta. De forma predeterminada, la propiedad no se puede buscar.

HTTP/1.1 200 Created

Ejemplo 2: Creación de una propiedad de búsqueda personalizada

Solicitud

En el ejemplo siguiente se muestra cómo crear una propiedad personalizada que permite búsquedas llamada clientUniqueId para un contenedor.

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 obtener más información sobre cómo agregar el SDK al proyecto y crear una instancia de authProvider, consulte la documentación del SDK.

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 200 Created