你当前正在访问 Microsoft Azure Global Edition 技术文档网站。如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

Containers - List By Storage Account

Reference

Service:: Data Box Edge/Data Box Gateway

API Version:: 2021-02-01

Lists all the containers of a storage Account in a Data Box Edge/Data Box Gateway device.

GET https://management.azure.com/subscriptions/{subscriptionId}/resourceGroups/{resourceGroupName}/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/{deviceName}/storageAccounts/{storageAccountName}/containers?api-version=2021-02-01

URI Parameters

Name	In	Required	Type	Description
deviceName	path	True	string	The device name.
resourceGroupName	path	True	string	The resource group name.
storageAccountName	path	True	string	The storage Account name.
subscriptionId	path	True	string	The subscription ID.
api-version	query	True	string	The API version.

Responses

Name	Type	Description
200 OK	ContainerList	The collection of all the containers on the device.
Other Status Codes	CloudError	Error response describing why the operation failed.

Security

azure_auth

Azure Active Directory OAuth2 Flow

Type: oauth2
Flow: implicit
Authorization URL: https://login.microsoftonline.com/common/oauth2/authorize

Scopes

Name	Description
user_impersonation	impersonate your user account

Examples

ContainerListAllInDevice

Sample Request

HTTP

GET https://management.azure.com/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/testedgedevice/storageAccounts/storageaccount1/containers?api-version=2021-02-01

Sample Response

Status code:: 200

{
  "value": [
    {
      "properties": {
        "containerStatus": "OK",
        "dataFormat": "BlockBlob",
        "refreshDetails": {},
        "createdDateTime": "2019-10-20T23:14:32.3016929Z"
      },
      "id": "/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForDataBoxEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/EAuToWIN-6LJVNIFFB411021190437191/storageAccounts/storageaccount1/containers/blobcontainer1",
      "name": "blobcontainer1",
      "type": "Microsoft.DataBoxEdge/dataBoxEdgeDevices/storageAccounts/containers"
    },
    {
      "properties": {
        "containerStatus": "OK",
        "dataFormat": "BlockBlob",
        "refreshDetails": {},
        "createdDateTime": "2019-10-20T23:15:38.0077675Z"
      },
      "id": "/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForDataBoxEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/EAuToWIN-6LJVNIFFB411021190437191/storageAccounts/storageaccount1/containers/blobcontainer2",
      "name": "blobcontainer2",
      "type": "Microsoft.DataBoxEdge/dataBoxEdgeDevices/storageAccounts/containers"
    },
    {
      "properties": {
        "containerStatus": "OK",
        "dataFormat": "BlockBlob",
        "refreshDetails": {},
        "createdDateTime": "2019-10-20T23:13:27.8545799Z"
      },
      "id": "/subscriptions/4385cf00-2d3a-425a-832f-f4285b1c9dce/resourceGroups/GroupForDataBoxEdgeAutomation/providers/Microsoft.DataBoxEdge/dataBoxEdgeDevices/EAuToWIN-6LJVNIFFB411021190437191/storageAccounts/storageaccount1/containers/blobcontainer3",
      "name": "blobcontainer3",
      "type": "Microsoft.DataBoxEdge/dataBoxEdgeDevices/storageAccounts/containers"
    }
  ]
}

Definitions

Name	Description
AzureContainerDataFormat	Storage format used for the file represented by the share.
CloudError	An error response from the service.
CloudErrorBody	An error response from the service.
Container	Represents a container on the Data Box Edge/Gateway device.
ContainerList	Collection of all the containers on the Data Box Edge/Gateway device.
ContainerStatus	Current status of the container.
createdByType	The type of identity that created the resource.
RefreshDetails	Fields for tracking refresh job on the share or container.
SystemData	Metadata pertaining to creation and last modification of the resource.

AzureContainerDataFormat

Storage format used for the file represented by the share.

Name	Type	Description
AzureFile	string
BlockBlob	string
PageBlob	string

CloudError

An error response from the service.

Name	Type	Description
error	CloudErrorBody	The error details.

CloudErrorBody

An error response from the service.

Name	Type	Description
code	string	An identifier for the error. Codes are invariant and are intended to be consumed programmatically.
details	CloudErrorBody[]	A list of additional details about the error.
message	string	A message describing the error, intended to be suitable for display in a user interface.

Container

Represents a container on the Data Box Edge/Gateway device.

Name	Type	Description
id	string	The path ID that uniquely identifies the object.
name	string	The object name.
properties.containerStatus	ContainerStatus	Current status of the container.
properties.createdDateTime	string	The UTC time when container got created.
properties.dataFormat	AzureContainerDataFormat	DataFormat for Container
properties.refreshDetails	RefreshDetails	Details of the refresh job on this container.
systemData	SystemData	Container in DataBoxEdge Resource
type	string	The hierarchical type of the object.

ContainerList

Collection of all the containers on the Data Box Edge/Gateway device.

Name	Type	Description
nextLink	string	Link to the next set of results.
value	Container[]	The list of containers.

ContainerStatus

Current status of the container.

Name	Type	Description
NeedsAttention	string
OK	string
Offline	string
Unknown	string
Updating	string

createdByType

The type of identity that created the resource.

Name	Type	Description
Application	string
Key	string
ManagedIdentity	string
User	string

RefreshDetails

Fields for tracking refresh job on the share or container.

Name	Type	Description
errorManifestFile	string	Indicates the relative path of the error xml for the last refresh job on this particular share or container, if any. This could be a failed job or a successful job.
inProgressRefreshJobId	string	If a refresh job is currently in progress on this share or container, this field indicates the ARM resource ID of that job. The field is empty if no job is in progress.
lastCompletedRefreshJobTimeInUTC	string	Indicates the completed time for the last refresh job on this particular share or container, if any.This could be a failed job or a successful job.
lastJob	string	Indicates the id of the last refresh job on this particular share or container,if any. This could be a failed job or a successful job.

SystemData

Metadata pertaining to creation and last modification of the resource.

Name	Type	Description
createdAt	string	The timestamp of resource creation (UTC).
createdBy	string	The identity that created the resource.
createdByType	createdByType	The type of identity that created the resource.
lastModifiedAt	string	The type of identity that last modified the resource.
lastModifiedBy	string	The identity that last modified the resource.
lastModifiedByType	createdByType	The type of identity that last modified the resource.