Compartir a través de

Crear archivoStorageContainerTypeRegistration

Espacio de nombres: microsoft.graph

Cree o reemplace un objeto fileStorageContainerTypeRegistration . Este método registra un fileStorageContainerType en el inquilino.

En el caso de los contenedores estándar, la facturación debe ser válida para que el registro se complete correctamente.

Importante

  • Una aplicación solo puede registrar un archivoStorageContainerType que posee, ya sea mediante tokens delegados o solo de aplicación.
  • El registro de un tipo de contenedor en un inquilino recién creado puede producir un error si el inquilino aún no está totalmente listo. Es posible que tenga que esperar al menos una hora para poder registrar un tipo de contenedor en un nuevo inquilino.

La configuración no se puede modificar durante el registro.

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 Permiso con privilegios mínimos Permisos con privilegios más altos
Delegado (cuenta profesional o educativa) FileStorageContainerTypeReg.Selected FileStorageContainerTypeReg.Manage.All
Delegado (cuenta personal de Microsoft) No admitida. No admitida.
Aplicación FileStorageContainerTypeReg.Selected No disponible.

Nota:

  • Cuando se usan tokens delegados, se requiere el rol de administrador de SharePoint Embedded o el rol de administrador global.
  • El registro debe realizarse en el contexto de la aplicación propietaria del archivoStorageContainerType.

Solicitud HTTP

Para registrar un archivoStorageContainerType en el inquilino actual.

PUT /storage/fileStorage/containerTypeRegistrations/{fileStorageContainerTypeId}

Nota: Use el método PUT. Esta solicitud crea un objeto fileStorageContainertypeRegistration con el identificador proporcionado (fileStorageContainerTypeId).

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 del objeto fileStorageContainerTypeRegistration .

Puede especificar la siguiente propiedad al crear un archivoStorageContainerTypeRegistration.

Propiedad Tipo Description
applicationPermissionGrants colección fileStorageContainerTypeAppPermissionGrant Privilegios de acceso de aplicaciones en contenedores de un archivo específicoStorageContainerType. Opcional.

Respuesta

Si se ejecuta correctamente, este método devuelve un 201 Created código de respuesta y un objeto fileStorageContainerTypeRegistration en el cuerpo de la respuesta.

Ejemplos

Ejemplo 1: Creación de un archivoStorageContainerTypeRegistration para un archivo de pruebaStorageContainerType

En el ejemplo siguiente se muestra cómo crear un archivoStorageContainerTypeRegistration para un archivo de pruebaStorageContainerType con algunos applicationPermissionGrants.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PUT https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypeRegistrations/de988700-d700-020e-0a00-0831f3042f00
Content-Type: application/json

{
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    },
    {
      "appId": "d893fd02-3578-4c7f-bd85-12fc3358af48",
      "delegatedPermissions": ["readContent"],
      "applicationPermissions": ["read"]
    }
  ]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

Nota: Se puede acortar el objeto de respuesta que se muestra aquí para mejorar la legibilidad.

HTTP/1.1 201 Created
Content-Type: application/json

{
  "@odata.type": "#microsoft.graph.fileStorageContainerTypeRegistration",
  "id": "de988700-d700-020e-0a00-0831f3042f00",
  "name": "Test Trial Container",
  "owningAppId": "11335700-9a00-4c00-84dd-0c210f203f00",
  "billingClassification": "trial",
  "billingStatus": "valid",
  "registeredDateTime": "01/20/2025",
  "expirationDateTime": "02/20/2025",
  "etag": "RVRhZw==",
  "settings": {
    "@odata.type": "microsoft.graph.fileStorageContainerTypeRegistrationSettings",
    "sharingCapability": "disabled",
    "urlTemplate": "https://app.contoso.com/redirect?tenant={tenant-id}&drive={drive-id}&folder={folder-id}&item={item-id}",
    "isDiscoverabilityEnabled": true,
    "isSearchEnabled": true,
    "isItemVersioningEnabled": true,
    "itemMajorVersionLimit": 50,
    "maxStoragePerContainerInBytes": 104857600,
    "isSharingRestricted": false
  },
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    },
    {
      "appId": "d893fd02-3578-4c7f-bd85-12fc3358af48",
      "delegatedPermissions": ["readContent"],
      "applicationPermissions": ["read"]
    }
  ]
}

Ejemplo 2: Crear un archivoStorageContainerTypeRegistration para un archivo estándarStorageContainerType donde no se completa la configuración de facturación

En el ejemplo siguiente se muestra cómo crear un archivoStorageContainerTypeRegistration para un archivo estándarStorageContainerType donde no se completa la configuración de facturación.

Solicitud

En el ejemplo siguiente se muestra la solicitud.

PUT https://graph.microsoft.com/v1.0/storage/fileStorage/containerTypeRegistrations/52a2630c-5e6a-41ff-8645-15406bafe66a
Content-Type: application/json

{
  "applicationPermissionGrants": [
    {
      "appId": "11335700-9a00-4c00-84dd-0c210f203f00",
      "delegatedPermissions": ["readContent", "writeContent"],
      "applicationPermissions": ["full"]
    }
  ]
}

Respuesta

En el ejemplo siguiente se muestra la respuesta.

HTTP/1.1 405 Method Not Allowed
  • Last updated on