import Global from '../../_global.mdx';
import Tabs from '@theme/Tabs';
import TabItem from '@theme/TabItem';

# spe containertype get

Gets a specific container type

## Usage

```sh
m365 containertype get [options]
```

## Options

```md definition-list
`-i, --id [id]`
: The ID of the container type. Specify either id or name but not both.

`-n, --name [name]`
: The container type name. Specify either id or name but not both.
```

<Global />

## Remarks

:::warning

The command is based on an API that is currently in preview and is subject to change once the API reached general availability.

:::

## Permissions

<Tabs>
  <TabItem value="Delegated">

  | Resource        | Permissions                         |
  |-----------------|-------------------------------------|
  | Microsoft Graph | FileStorageContainerType.Manage.All |

  :::info

  To use this command you must be either **SharePoint Administrator** or **Global Administrator**.

  :::

  </TabItem>
  <TabItem value="Application">

  This command does not support application permissions.

  </TabItem>
</Tabs>

## Examples

Gets container type by ID

```sh
m365 spe containertype get --id 5de5c251-61c2-40f5-8947-5a719c1c0b71
```

Gets container type by name

```sh
m365 spe containertype get --name 'Container Type 1'
```

## Response

<Tabs>
  <TabItem value="JSON">

  ```json
  {
    "id": "5de5c251-61c2-40f5-8947-5a719c1c0b71",
    "name": "Container Type 1",
    "owningAppId": "a6f79b17-a0f5-47d1-bfde-9995caebc2a3",
    "billingClassification": "standard",
    "billingStatus": "invalid",
    "createdDateTime": "2025-06-19T05:17:32.0760075Z",
    "etag": "MC4wLjAuMA==",
    "settings": {
      "urlTemplate": "",
      "isDiscoverabilityEnabled": false,
      "isSearchEnabled": true,
      "isItemVersioningEnabled": true,
      "itemMajorVersionLimit": 500,
      "maxStoragePerContainerInBytes": 27487790694400,
      "isSharingRestricted": false,
      "consumingTenantOverridables": ""
    }
  }
  ```

  </TabItem>
  <TabItem value="Text">

  ```text
  billingClassification: standard
  billingStatus        : invalid
  createdDateTime      : 2025-06-19T05:17:32.0760075Z
  etag                 : MC4wLjAuMA==
  id                   : 5de5c251-61c2-40f5-8947-5a719c1c0b71
  name                 : Container Type 1
  owningAppId          : a6f79b17-a0f5-47d1-bfde-9995caebc2a3
  settings             : {"urlTemplate":"","isDiscoverabilityEnabled":false,"isSearchEnabled":true,"isItemVersioningEnabled":true,"itemMajorVersionLimit":500,"maxStoragePerContainerInBytes":27487790694400,"isSharingRestricted":false,"consumingTenantOverridables":""}
  ```

  </TabItem>
  <TabItem value="CSV">

  ```csv
  id,name,owningAppId,billingClassification,billingStatus,createdDateTime,etag
  5de5c251-61c2-40f5-8947-5a719c1c0b71,Container Type 1,a6f79b17-a0f5-47d1-bfde-9995caebc2a3,standard,invalid,2025-06-19T05:17:32.0760075Z,MC4wLjAuMA==
  ```

  </TabItem>
  <TabItem value="Markdown">

  ```md
  # spe containertype get --id "5de5c251-61c2-40f5-8947-5a719c1c0b71"

  Date: 27/08/2025

  ## Container Type 1 (5de5c251-61c2-40f5-8947-5a719c1c0b71)

  Property | Value
  ---------|-------
  id | 5de5c251-61c2-40f5-8947-5a719c1c0b71
  name | Container Type 1
  owningAppId | a6f79b17-a0f5-47d1-bfde-9995caebc2a3
  billingClassification | standard
  billingStatus | invalid
  createdDateTime | 2025-06-19T05:17:32.0760075Z
  etag | MC4wLjAuMA==
  ```

  </TabItem>
</Tabs>

## More information

In SharePoint Embedded, all files and documents are stored in Containers, and each Container is identified by a Container Type.

Container Type is a property stamped on every Container instance. Each Container Type is owned by one Application, and each Application can own only one Container Type.

The primary function of a Container Type is to manage the application workload that can access the Containers. Container Type defines the access permissions an Application has towards all Containers of that type, including create, read, write, delete containers; manage container permissions, etc.

More information about SharePoint Embedded and the limits can be found at the following location: [SharePoint Embedded](https://learn.microsoft.com/en-us/sharepoint/dev/embedded/concepts/app-concepts/containertypes#sharepoint-embedded-trial-container-types)
