Creare un contenitore BLOB con Java
I BLOB in Archiviazione di Azure sono organizzati in contenitori. Prima di poter caricare un BLOB, è necessario creare un contenitore. Questo articolo illustra come creare i contenitori con la libreria client di Archiviazione di Azure per Java.
Prerequisiti
- Questo articolo presuppone che sia già stato configurato un progetto per l'uso con la libreria client di Archiviazione BLOB di Azure per Java. Per informazioni sulla configurazione del progetto, incluse l'installazione del pacchetto, l'aggiunta di direttive
import
e la creazione di un oggetto client autorizzato, vedere Introduzione ad Archiviazione di Azure e Java. - Il meccanismo di autorizzazione deve disporre delle autorizzazioni per creare un contenitore BLOB. Per altre informazioni, vedere le linee guida per l'autorizzazione per l'operazione API REST seguente:
Informazioni sulla denominazione dei contenitori
Un nome contenitore deve essere un nome DNS valido, perché fa parte dell'URI univoco usato per fare riferimento al contenitore o ai relativi BLOB. Seguire queste regole per la denominazione di un contenitore:
- I nomi dei contenitori devono avere una lunghezza compresa fra 3 e 63 caratteri.
- I nomi dei contenitori devono iniziare con una lettera o un numero e possono contenere solo lettere, numeri e il carattere del trattino (-).
- Nei nomi di contenitori non sono consentiti caratteri trattino consecutivi.
Il formato dell'URI per una risorsa contenitore è il seguente:
https://my-account-name.blob.core.windows.net/my-container-name
Creazione di un contenitore
Per creare un contenitore, chiamare uno dei metodi seguenti dalla classe BlobServiceClient
:
È anche possibile creare un contenitore usando uno dei metodi seguenti dalla classe BlobContainerClient
:
I contenitori vengono creati immediatamente sotto l'account di archiviazione. Non è possibile annidare un contenitore in un altro. Per i metodi create
e createBlobContainer
viene generata un'eccezione se esiste già un contenitore con lo stesso nome.
L'esempio seguente crea un contenitore da un oggetto BlobServiceClient
:
public BlobContainerClient createContainer(BlobServiceClient blobServiceClient, String containerName) {
// Create the container using the service client object
BlobContainerClient blobContainerClient = blobServiceClient.createBlobContainer(containerName);
return blobContainerClient;
}
Creare il contenitore radice
Un contenitore radice funge da contenitore predefinito per l'account di archiviazione. Ogni account di archiviazione può avere un contenitore radice, che deve essere denominato $root. Il contenitore radice deve essere creato o eliminato in modo esplicito.
È possibile fare riferimento a un BLOB archiviato nel contenitore radice senza includere il nome del contenitore radice. Il contenitore radice consente di fare riferimento a un BLOB al primo livello della gerarchia dell'account di archiviazione. Ad esempio, è possibile fare riferimento a un BLOB che si trova nel contenitore radice nel modo seguente:
https://accountname.blob.core.windows.net/default.html
L'esempio seguente crea un nuovo oggetto BlobContainerClient
con il nome del contenitore $root, quindi crea il contenitore se non esiste già nell'account di archiviazione:
public void createRootContainer(BlobServiceClient blobServiceClient) {
// Creates a new BlobContainerClient object by appending the containerName to
// the end of the URI
BlobContainerClient blobContainerClient = blobServiceClient.getBlobContainerClient("$root");
// If the container does not already exist, create it using the container client
blobContainerClient.createIfNotExists();
}
Risorse
Per altre informazioni sulla creazione di un contenitore tramite la libreria client di Archiviazione BLOB di Azure per Java, vedere le risorse seguenti.
Operazioni dell'API REST
Azure SDK per Java contiene librerie basate sull'API REST di Azure, che consentono di interagire con le operazioni dell'API REST tramite paradigmi Java noti. I metodi della libreria client per la creazione di un contenitore usano l'operazione API REST seguente:
- Create Container (API REST)
Esempi di codice
Risorse della libreria client
Commenti e suggerimenti
https://aka.ms/ContentUserFeedback.
Presto disponibile: Nel corso del 2024 verranno gradualmente disattivati i problemi di GitHub come meccanismo di feedback per il contenuto e ciò verrà sostituito con un nuovo sistema di feedback. Per altre informazioni, vedereInvia e visualizza il feedback per