IBM Cloud Docs
Visualizzazione delle condivisioni file, dei bind di condivisione e delle destinazioni di montaggio

Visualizzazione delle condivisioni file, dei bind di condivisione e delle destinazioni di montaggio

È possibile visualizzare tutte le condivisioni di file, i loro binding e i target di montaggio nella console, recuperare le informazioni dalla CLI, con l'API o con Terraform. È possibile richiamare le informazioni per tutte le condivisioni, i bind e le destinazioni di montaggio o solo le informazioni di una risorsa specifica.

Visualizzazione delle condivisioni di file, dei collegamenti alle condivisioni e dei target di montaggio nella console

Visualizzazione di tutte le condivisioni di file nella console

  1. Nella console IBM Cloud console, fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC Archiviazione > File Shares.

  2. La pagina di elenco Condivisioni file per VPC mostra tutte le condivisioni file create in quella zona. Le opzioni del menu Azioni icona Azioni vengono utilizzate per gestire le condivisioni file. La tabella seguente descrive le informazioni nella pagina di elenco.

Pagina dell'elenco delle condivisioni di file.
Campo Valore
Regione Area account per la condivisione file. Selezionare una regione differente per visualizzare le condivisioni file per le zone in tale regione.
Nome Il nome della condivisione file. Può essere la condivisione file originale o una condivisione file di replica. Fare clic sul nome per visualizzare i dettagli su tale condivisione file.
Condizione Per un elenco degli stati delle condivisioni file, consultare Stati del ciclo di vita della condivisione file.
Gruppo di risorse Il campo visualizza il nome del gruppo di risorse a cui appartiene la condivisione di file.
Posizione Il campo visualizza la zona in cui si trova la condivisione di file.
Destinazioni di montaggio Numero di destinazioni di montaggio associate alla condivisione file. È possibile avere una destinazione di montaggio per VPC e per condivisione di file.
Istantanee Questo campo mostra il numero di istantanee eseguite sulla condivisione di file. Questa colonna è nascosta per impostazione predefinita. Fare clic sull' icona Impostazioni per selezionare le colonne che si desidera visualizzare.
Dimensione Dimensione della condivisione file, in GB.
Ruolo trasversale I valori di questa colonna possono essere Nessuno, Compartecipazione all'origine o Compartecipazione all'autore. Se il valore è Nessuno, la condivisione non è condivisa con un altro account o servizio esterno. Se il valore è Frequenza di origine, la condivisione è condivisa con un altro account o servizio esterno ed è legata a una condivisione accessoria nell'altro account. Se il valore è Accessor share, questa share è legata a una share di origine con lo scopo di accedere ai dati della share di origine.
Ruolo di replica Relazione tra l'origine e la condivisione di file di replica. "Replica di" indica che il file condivide una copia della condivisione di origine, che è collegata. "Origine di" indica che la condivisione dell'origine della replica, che è collegata. "Nessuno" indica che la condivisione file non viene replicata con un'altra condivisione.
Stato di replica Questa colonna è nascosta per impostazione predefinita. Fare clic sull' icona Impostazioni per selezionare le colonne che si desidera visualizzare.
Tipo di crittografia Mostra il tipo di codifica della condivisione file, gestita dal provider o gestita dal cliente. Crittografia gestita dal cliente utilizza le tue chiavi root per proteggere i dati. La IU identifica anche il KMS (key management service), Key Protect o Hyper Protect Crypto Services.

È possibile accedere al menu Azioni facendo clic sull'icona Azioni. Il menu Azioni contiene opzioni per la gestione della condivisione file, a seconda dello stato. Per una condivisione file in stato stabile , puoi rinominare la condivisione, modificare IOPS, copiare il CRN della condivisione, creare una replica o eliminare una condivisione file. Elimina e Crea replica sono disabilitati se si imposta già la replica su una condivisione file di replica. Per ulteriori informazioni, vedere Creazione di condivisioni di file di replica.

Visualizzazione dei dettagli di una condivisione di file nella console

  1. Andare alla lista di tutte le condivisioni file. Dalla console IBM Cloud console, fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC Archiviazione > File Shares.

  2. Fare clic sul nome di una condivisione file per visualizzare la pagina dei dettagli. Vengono visualizzati il nome e lo stato modificabili della condivisione file. Se alla condivisione di file sono stati applicati tag per la gestione degli utenti o degli accessi, questi sono elencati accanto allo stato. Fare clic su Aggiungi tag per applicare nuovi tag alla condivisione.

  3. La pagina dei dettagli presenta diverse schede. La scheda Overview è visualizzata per impostazione predefinita.

    • Vista d'insieme- La tabella seguente descrive le informazioni disponibili per la condivisione di file.

      Pagina dei dettagli delle condivisioni di file
      Campo Valore
      Dettagli condivisione file
      Nome Il nome della condivisione file. Fare clic sull'icona Modifica Icona Modifica per modificare il nome.
      ID condivisione file L'UUID generato al momento della creazione della condivisione di file.
      Gruppo di risorse I gruppi di risorse associati alla condivisione file nel tuo account.
      Data di creazione Data di creazione della condivisione di file.
      Posizione Il percorso della condivisione di file (ad esempio, us-south-2 ).
      Ruolo di replica Replica o condivisione file di origine.
      Crittografia Specifica la crittografia gestita dal cliente o gestita dal provider. Quando la condivisione di file è crittografata con chiavi gestite dal cliente, vengono visualizzati anche l'istanza di crittografia, il nome della chiave di crittografia e il CRN della chiave di crittografia.
      Modalità di accesso della destinazione di montaggio L'accesso alla condivisione file viene concesso da un gruppo di sicurezza all'interno di una sottorete o a qualsiasi istanza del server virtuale nel VPC. Fare clic su Icona Modifica Icona Modifica per cambiare le modalità di accesso. L'accesso al gruppo di protezione è disponibile solo per le condivisioni file create con il profilo dp2. Per ulteriori informazioni, vedi Modalità di accesso della destinazione di montaggio.
      CRN Il nome della risorsa cloud copiabile della condivisione di file.
      Crittografia consentita in modalità di transito Questo valore indica se la crittografia in transito è richiesta quando i client accedono alla condivisione file. Fare clic sull'icona Modifica icona Modifica per modificare i valori consentiti. I valori possibili sono Gestito dall'utente e Nessuno. Questo campo non è applicabile alle condivisioni di file con modalità di accesso VPC.
      Ruolo trasversale I valori possibili sono Nessuno, Origine, Accessore. Questo campo non è applicabile alle condivisioni di file con modalità di accesso VPC.
      Conteggio istantanee Questo valore indica il numero di istantanee eseguite sulla condivisione di file. Questo campo non è applicabile alle condivisioni di file con modalità di accesso VPC.
      Dimensione dei dati modificati in tutte le istantanee Rappresenta il volume di dati fatturabile di tutte le istantanee. Questo campo non è applicabile alle condivisioni di file con modalità di accesso VPC.
      Dettagli profilo
      Profilo Il nome del profilo di condivisione che definisce le prestazioni della condivisione di file. Nella maggior parte dei casi, il profilo dp2.
      Dimensione Capacità della condivisione file in GB.
      Numero massimo IOPS IOPS massimo per la quota specificata.
      Destinazioni di montaggio Numero di destinazioni di montaggio associate alla condivisione file. È possibile avere una destinazione di montaggio per VPC e per condivisione di file. È possibile creare più destinazioni di montaggio per altri VPC. Fare clic su Icona Azioni per ridenominare o eliminare la destinazione di montaggio o per visualizzarne il percorso.
      Nome Nome della destinazione di montaggio.
      Condizione Stato della destinazione di montaggio sul VPC.
      VPC (Virtual Private Cloud) Questo campo viene visualizzato se la condivisione file ha la modalità di accesso VPC. Fai clic sul nome per andare alla pagina dei dettagli per tale VPC, dove puoi visualizzare un elenco di condivisioni file che hanno una destinazione di montaggio in tale VPC.
      Sottorete Questo campo viene visualizzato se la condivisione file ha la modalità di accesso del gruppo di sicurezza. Fare clic sul nome della sottorete per visualizzarne i dettagli.
      Gruppo di sicurezza Questo campo viene visualizzato se la condivisione file ha la modalità di accesso del gruppo di sicurezza. È il numero di gruppi di sicurezza di cui la condivisione è membro.
      IP riservato Questo campo viene visualizzato se la condivisione file ha la modalità di accesso del gruppo di sicurezza. L'indirizzo IP dell'interfaccia di rete virtuale collegata alla destinazione di montaggio
      Crittografia in transito Questo campo viene visualizzato se la condivisione file ha la modalità di accesso del gruppo di sicurezza. Il suo valore può essere abilitato o disabilitato.
      Bind a condivisioni accessor Questa sezione viene visualizzata se la quota ha quote accessorie in altre VPC.
      ID di bind Questo campo mostra l'ID del bind che connette la condivisione di origine alla condivisione dell'accessor.
      ID account L'ID dell'account che ha accesso ai dati della tua condivisione tramite la condivisione dell'accessor.
      ID accessor Questo campo mostra l'ID account che ha creato la condivisione accessor in un altro VPC.
      Condizione Visualizza lo stato del ciclo di vita della condivisione file del programma di accesso. Lo stato Stable è previsto
      Data di creazione La data e l'ora in cui è stata creata la condivisione accessor.
      Relazione di replica di condivisione file

      Mostra il nome, l'ubicazione e lo stato delle condivisioni file di origine e di replica

      • Se non è stata creata alcuna condivisione file di replica, fare clic su Crea replica per crearne una.
      • Per interrompere la relazione di duplicazione, fare clic su Rimuovi relazione di duplicazione. Quindi, la condivisione file di replica diventa una condivisione file di lettura/scrittura indipendente.
      Frequenza di replica Passare con il mouse sull'icona delle informazioni per visualizzare una spiegazione della pianificazione della replica cron.
      Condizione Stato della replica; ad esempio, sospeso o disponibile.
      Ora di inizio ultima sincronizzazione La data e l'ora dell'ultimo avvio della replica.
      Ora di completamento ultima sincronizzazione La data e l'ora dell'ultima replica terminata.
      Velocità di trasferimento Mostra la velocità con cui i dati sono stati copiati dalla condivisione file di origine alla relativa replica durante l'ultima sincronizzazione.
      Importo trasferimento La quantità di dati copiati dalla condivisione file di origine alla relativa replica durante l'ultima sincronizzazione.
      Ruolo di replica Condivisione file di origine o di replica.
      Nome condivisione file Fare clic sul nome della condivisione file per visualizzarne i dettagli.
      Posizione Visualizza le informazioni sulla zona della condivisione file.
      Condizione Visualizza lo stato del ciclo di vita della condivisione file. Lo stato Stable è previsto.

    • Istantanee- Nella scheda Istantanee è possibile trovare un riepilogo relativo a tutte le istantanee e l'elenco delle istantanee eseguite sulla condivisione di file.

      • Il riepilogo delle istantanee fornisce informazioni quali il numero di istantanee, il volume di dati complessivo catturato nelle istantanee e il ruolo di replica.
      • L'elenco Istantanee mostra le istantanee scattate sulla condivisione di file. È possibile vedere il nome, la dimensione della condivisione di file quando è stata scattata l'istantanea e lo stato dell'istantanea. È possibile fare clic su Crea per acquisire una nuova istantanea. Fare clic sull'icona Azioni Icona Azioni Azioni per visualizzare il menu Azioni. Il menu Azioni presenta 2 opzioni: Ripristina e Cancella.

    • Monitoraggio- Nella scheda Monitoraggio sono visualizzati tre grafici relativi all'utilizzo della condivisione, al throughput totale e agli IOPS totali. Questi grafici sono disponibili gratuitamente, anche senza un'istanza IBM Cloud Monitoring. È possibile personalizzare l'intervallo di date per visualizzare i dati nel tempo.

      Il monitoraggio di queste metriche di utilizzo può aiutare a determinare quanto lavoro viene svolto dall'applicazione o dal carico di lavoro. Queste informazioni possono essere utilizzate per determinare se il valore IOPS deve essere regolato. Il monitoraggio della capacità disponibile della condivisione può aiutare a identificare la necessità di maggiore spazio di archiviazione prima che lo spazio insufficiente diventi un problema per la scrittura dei dati sulla condivisione o per la replica. La visione di queste metriche può aiutare ad anticipare eventuali variazioni degli addebiti alla fine del periodo di fatturazione.

      Queste metriche non vengono aggiornate in tempo reale. I dati relativi alle nuove condivisioni di file possono richiedere fino a un'ora o un'ora e 15 minuti per essere visualizzati nel dashboard. Le variazioni di utilizzo possono richiedere da 15 a 30 minuti per essere riflesse nei grafici.

      Se si dispone di un'istanza del servizio IBM Cloud Monitoring, fare clic su Avvia monitoraggio per aprire l'interfaccia web di Sysdig e lavorare con i dashboard delle metriche. Per ulteriori informazioni su come impostare l'istanza IBM Cloud Monitoring, vedere Monitoraggio delle metriche per File Storage for VPC.

Visualizzazione di tutte le condivisioni di file per una VPC nella console

Puoi visualizzare tutte le condivisioni file che hanno una destinazione di montaggio su un VPC visualizzando la pagina dei dettagli del VPC.

  1. Vai a un VPC:

    1. Dalla pagina dei dettagli delle condivisioni file, fai clic sul link VPC nell'elenco delle destinazioni di montaggio.
    2. Dall'interfaccia utente, fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC > Rete > VPC. Fare clic sul nome di un VPC nell'elenco.

  2. Nella pagina dei dettagli VPC, scorri fino a Condivisioni file in questo VPC.

Visualizzazione dei dettagli del target di montaggio nella console

  1. Andare alla lista di tutte le condivisioni file. Dalla console IBM Cloud console, fare clic sull'icona Menu di navigazione Icona menu > Infrastruttura Icona VPC Archiviazione > File Shares.
  2. Fare clic sul nome di una condivisione file per visualizzare la pagina dei dettagli.
  3. Scorrere fino alla sezione Destinazioni di montaggio per visualizzare l'elenco delle destinazioni di montaggio. L'elenco contiene i nomi e gli stati della destinazione di montaggio e il VPC a cui appartiene la destinazione di montaggio.
  4. Fare clic sull'icona Azioni icona Azioni per visualizzare il menu Azioni. Il menu Azioni contiene 3 opzioni: Rinomina, Visualizza percorso ed Elimina.
  5. Fare clic su Visualizza percorso per visualizzare le informazioni sul percorso di montaggio che è possibile copiare e incollare nei comandi di montaggio.

Visualizzazione delle condivisioni file, dei bind di condivisione e delle destinazioni di montaggio dalla CLI

Prima di poter utilizzare la CLI, è necessario installare la CLI IBM Cloud e il plug-in CLI VPC. Per ulteriori informazioni, vedi i prerequisiti della CLI.

Visualizzazione di tutte le condivisioni file dalla CLI

Puoi elencare tutte le tue condivisioni file in una regione con il comando ibmcloud is shares.

ibmcloud is shares
Listing shares in all resource groups and region us-south under account Test Account as user test.user@ibm.com...

ID                                          Name                    Lifecycle state   Zone         Profile   Size(GB)   Resource group   Replication role   Accessor binding role   Snapshot count   Snapshot size   
r006-a8d6af48-0c97-4c6b-bab1-fbefdc1e1e03   my-file-share           stable            us-south-2   dp2       10         defaults         none               none                    0                0   
r006-aaf4bfe9-358c-4faa-a4ec-0b955090b940   my-file-share-2         stable            us-south-2   dp2       10         defaults         none               none                    0                0   
r006-a60bfa90-a893-40ad-be34-28ab51a963f9   replica-dal-2           stable            us-south-2   dp2       10         defaults         replica            none                    0                0   
r006-3f21e3c3-e12d-425f-ab77-810cabfde8df   source-dal-1            stable            us-south-1   dp2       10         defaults         source             none                    0                0   
r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-share-dal-1  stable            us-south-1   dp2       10         defaults         replica            none                    0                0   
r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   stable            us-south-2   dp2       10         defaults         source             none                    0                0

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is shares. Per ulteriori informazioni su lifecycle state, consultare Stati della condivisione file. Stable.

Visualizzazione dei dettagli di una condivisione file da CLI

Per visualizzare i dettagli di una condivisione file, eseguire il comando ibmcloud is share e specificare la condivisione file per ID o nome.

Il seguente esempio identifica la condivisione file per ID. Questa condivisione è una replica basata sul profilo dp2 e l'accesso alla condivisione viene concesso utilizzando i gruppi di protezione. L'output fornisce informazioni sulla condivisione file di origine e sui dettagli della replica.

$ ibmcloud is share r006-455b601c-8fc1-4476-8771-4708c49c8ef7
Getting file share r006-455b601c-8fc1-4476-8771-4708c49c8ef7 under account Test Account as user test.user@ibm.com...

ID                                 r006-455b601c-8fc1-4476-8771-4708c49c8ef7   
Name                               my-replica-share-dal-1   
CRN                                crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-455b601c-8fc1-4476-8771-4708c49c8ef7   
Lifecycle state                    stable   
Access control mode                security_group   
Accessor binding role              none   
Allowed transit encryption modes   none,user_managed   
Zone                               us-south-1   
Profile                            dp2   
Size(GB)                           10   
IOPS                               100   
Encryption                         provider_managed   
Mount Targets                      ID                          Name      
                                   No mounted targets found.      

Resource group                     ID                                 Name      
                                   6edefe513d934fdd872e78ee6a8e73ef   defaults      

Created                            2025-04-04T09:19:27+00:00   
Latest job                         Job status   Job status reasons      
                                   succeeded    -      

Latest Sync                        Completed At                Data Transferred   Started At      
                                   2025-04-18T21:00:04+00:00   3560               2025-04-18T21:00:00+00:00      

Replication cron spec              00 * * * *   
Replication role                   replica   
Replication status                 active   
Replication status reasons         Status code   Status message      
                                   -             -      

Source share                       ID                                          Name                    Resource type      
                                   r006-4dadac27-cd17-42df-a5fe-1388705d33e0   my-source-share-dal-2   share      

Snapshot count                     0   
Snapshot size                      0   
Source snapshot                    -

È possibile utilizzare il nome della condivisione di origine per richiamarne i dettagli. Vedi il seguente esempio.

$ ibmcloud is share my-source-file-share
Getting file share my-source-file-share under account Test Account as user test.user@ibm.com...

ID                               r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   
Name                             my-source-file-share   
CRN                              crn:v1:bluemix:public:is:us-south-2:a/a1234567b::share:r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   
Lifecycle state                  stable   
Access control mode              security_group
Accessor binding role            origin
Allowed transit encryption modes user_managed,none
Zone                             us-south-2   
Profile                          dp2   
Size(GB)                         1500   
IOPS                             2000   
User Tags                        env:dev   
Encryption                       provider_managed   
Mount Targets                    ID                                          Name      
                                 r006-fdbffc45-618c-49f1-bb08-ec530d7be378   my-source-mount-target      

Resource group                   ID                                 Name      
                                 db8e8d865a83e0aae03f25a492c5b39e   Default      

Created                          2024-06-25T15:42:53+00:00   
Latest job                       Job status   Job status reasons      
                                 succeeded    -      

Replication share                ID                                          Name                    Resource type      
                                 r006-dc6a644d-c7da-4c91-acf0-d66b47fc8516   my-replica-file-share   share      

Replication role                 source   
Replication status               active   
Replication status reasons       Status code   Status message      
                                 -             -
Snapshot count                   0
Snapshot size                    0

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share.

Visualizzazione dei bind di condivisione di una condivisione file dalla CLI

Per visualizzare i binding delle condivisioni accessorie collegate a una condivisione di origine dalla CLI, utilizzare il comando ibmcloud is share-accesssor-bindings. Vedi il seguente esempio.

$ ibmcloud is share-accessor-bindings my-origin-share
Listing accessor bindings for the share ID my-origin-share under account Test Account as user test.user@ibm.com...

ID                                           Lifecycle state  Created at                 Accessor CRN
r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3   stable           2024-06-25T00:50:57+05:30  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-925214bc-ded5-4626-9d8e-bc4e2e579232

Visualizzazione di un bind di condivisione specifico di una condivisione file dalla CLI

Per visualizzare un binding specifico della condivisione accessor collegato a una condivisione di origine dalla CLI, utilizzare il comando ibmcloud is share-accesssor-binding. Vedi il seguente esempio.

$ ibmcloud is share-accessor-binding my-origin-share r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Get accessor binding r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3 for the share ID my-origin-share under account Test Account as user test.user@ibm.com...

ID               r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Created          2024-06-25T00:50:57+05:30
Href             https://us-south.iaas.cloud.ibm.com/v1/shares/r006-d73v40a6-e08f-4d07-99e1-d28cbf2188ed/bindings/r-006-c2e53b1b-3b15-4792-8d96-c9c035fd65c3
Resource type    share_accessor_binding
Lifecycle state  stable
Accessor         Resource type  Name               CRN
                 share          my-accessor-share  crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-925214bc-ded5-4626-9d8e-bc4e2e579232

Visualizzazione delle destinazioni di montaggio per una condivisione file dalla CLI

Per visualizzare tutte le destinazioni di montaggio create per una condivisione file, esegui il comando ibmcloud is share-mount-targets e specifica l'ID condivisione file.

$ ibmcloud is share-mount-targets  r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a
Listing share mount target of r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a in all resource groups and region us-south under account Test Account as user test.user@ibm.com...
ID                                          Name                     VPC      Lifecycle state   Transit Encryption   
r006-fdbffc45-618c-49f1-bb08-ec530d7be378   my-source-mount-target   my-vpc   stable            none

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share-mount-targets.

Visualizzazione dei dettagli della destinazione di montaggio dalla CLI

Per visualizzare informazioni più dettagliate su una destinazione di montaggio, eseguire il comando ibmcloud is share-mount-target e specificare l'ID o il nome della condivisione con il nome o l'ID della destinazione di montaggio. Vedi il seguente esempio.

$ ibmcloud is share-mount-target  r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a my-source-mount-target
Getting mount target ID my-source-mount-target for share ID r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a under account Test Account as user test.user@ibm.com...

ID                          r006-fdbffc45-618c-49f1-bb08-ec530d7be378   
Name                        my-source-mount-target   
VPC                         ID                                          Name      
                            r006-6e8fb140-5668-45b8-b98a-d5cb0e0bf39b   my-vpc      

Access control mode         security_group   
Resource type               share_mount_target   
Virtual network interface   ID                                          Name      
                            r006-3b0c00fa-0ce3-4ff8-9a5d-c7a645fbe530   my-source-vni      

Lifecycle state             stable   
Mount path                  10.240.64.6:/5975a795_e5e7_474c_82d3_46c1d4159c6a   
Transit Encryption          none   
Created                     2023-10-19T15:42:54+00:00

Per ulteriori informazioni relative alle opzioni del comando, consultare ibmcloud is share-mount-target.

Visualizzazione delle condivisioni file, dei bind di condivisione e delle destinazioni di montaggio con l'API

Puoi visualizzare in modo programmatico le condivisioni e le destinazioni di montaggio richiamando il metodo /shares in API VPC come mostrato nelle seguenti richieste di esempio.

È necessario fornire il parametro generation e specificare generation=2. Per ulteriori informazioni, vedere Generazione nel riferimento API Virtual Private Cloud.

Visualizzazione dello stato della replica e di lifecycle_state con la API

  • lifecycle_state
    • Questa proprietà fornisce lo stato corrente di una risorsa tramite il metodo Richiama una condivisione file. I valori forniti da lifecycle_state sono generici e si applicano a varie risorse, non solo alle condivisioni di file. lifecycle_state indica se la condivisione di file è stabile, in aggiornamento, in cancellazione, sospesa e così via. Stable è atteso. Per ulteriori informazioni, consultare Stati della condivisione file.
  • replication_status

Visualizzazione di tutte le condivisioni file con l'API

Effettuare una richiesta GET /shares per elencare tutte le condivisioni file per una regione.

curl -X GET "$vpc_api_endpoint/v1/shares?version=2023-07-18?limit=50&generation=2" -H "Authorization: $iam_token"

Una risposta corretta si presenta come nell'esempio seguente. Nell'esempio, il parametro di query " limit specifica un limite di 50 condivisioni di file, anche se la risposta di esempio ne contiene solo una. Il valore della proprietà access_control_mode è vpc, che significa che la condivisione file può essere montata su tutte le istanze del server virtuale in un VPC.

{
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares?limit=50"
  },
  "limit": 50,
  "shares": [
    {
      "access_control_mode": "vpc",
      "created_at": "2023-07-18T13:02:17Z",
      "crn": "crn:[...]",
      "encryption": "provider_managed",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/51bba578-0dce-4f8a-aa6e-f06c899e2c8e",
      "id": "51bba578-0dce-4f8a-aa6e-f06c899e2c8e",
      "iops": 3000,
      "lifecycle_state": "stable",
      "name": "share-name1",
      "profile": {
        "family": "tiered",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/tier-10iops",
        "name": "tier-10iops",
        "resource_type": "share_profile"
      },
      "resource_group": {
        "crn": "crn:[...]",
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/60fc731a-1794-4f5d-ba51-ea24b5357207",
        "id": "60fc731a-1794-4f5d-ba51-ea24b5357207",
        "name": "Default"
      },
      "resource_type": "share",
      "size": 40,
      "mount_targets": [
        {
          "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/51bba578-0dce-4f8a-aa6e-f06c899e2c8e/mount_targets/d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
          "id": "d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
          "name": "mount-target-name1",
          "resource_type": "share_target",
          "vpc": {
            "crn": "crn:[...]",
            "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/c2d941de-27f5-432c-b4d0-37a8491c3216",
            "id": "c2d941de-27f5-432c-b4d0-37a8491c3216",
            "name": "vpc-name1",
            "resource_type": "vpc"
          }
        }
      ],
      "zone": {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
        "name": "us-south-1"
      }
    }
  ]
}

Visualizzazione di una singola condivisione di file con l'API

Effettuare una richiesta GET /shares/{share_id} per ottenere i dettagli su una singola condivisione file.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id?version=2025-04-01&generation=2"\
-H "Authorization: $iam_token"

Una risposta corretta si presenta come nell'esempio seguente. In questo esempio, la condivisione è stata creata con il profilo " dp2. Il valore della proprietà access_ control_mode è security_group, il che significa che l'accesso alla quota è determinato dalle regole di un gruppo di protezione.

{
  "access_control_mode": "security_group",
  "accessor_binding_role": "none",
  "accessor_bindings": [],
  "allowed_transit_encryption_modes": [
      "none",
      "user_managed"
  ],
  "created_at": "2025-04-04T09:17:14.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "encryption": "provider_managed",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "id": "r006-4dadac27-cd17-42df-a5fe-1388705d33e0",
  "iops": 100,
  "latest_job": {
      "status": "succeeded",
      "status_reasons": [],
      "type": "replication_init"
  },
  "lifecycle_reasons": [],
  "lifecycle_state": "stable",
  "mount_targets": [],
  "name": "my-source-share-dal-2",
  "profile": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
      "name": "dp2",
      "resource_type": "share_profile"
  },
  "replica_share": {
      "crn": "crn:v1:bluemix:public:is:us-south-1:a/a1234567::share:r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "id": "r006-455b601c-8fc1-4476-8771-4708c49c8ef7",
      "name": "my-replica-share-dal-1",
      "resource_type": "share"
  },
  "replication_role": "source",
  "replication_status": "active",
  "replication_status_reasons": [],
  "resource_group": {
      "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
      "id": "6edefe513d934fdd872e78ee6a8e73ef",
      "name": "defaults"
  },
  "resource_type": "share",
  "size": 10,
  "snapshot_count": 0,
  "snapshot_size": 0,
  "user_tags": [],
  "zone": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
      "name": "us-south-2"
  }
}

Elenca i bind di condivisione di una condivisione file con l'API

Effettuare una richiesta GET /shares/{id}/bindings per ottenere l'elenco di bind di una singola condivisione file. La richiesta elenca tutti i bind per una condivisione. Ogni collegamento viene creato implicitamente quando viene creata una condivisione accessor.

curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings?version=2024-03-20&generation=2"\
-H "Authorization: $iam_token"

Una risposta corretta si presenta come nell'esempio seguente.

{
  "bindings": [
    {
      "accessor": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
        "id": "r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
        "name": "my-accessor-share",
        "resource_type": "share"
      },
      "account": {
        "id": "a0000000000000000000000000000001",
        "resource_type": "account"
      },
      "created_at": "2022-01-07T16:56:54Z",
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r134-df760133-3513-47e7-b980-26cca666561b",
      "id": "r134-df760133-3513-47e7-b980-26cca666561b",
      "lifecycle_state": "stable",
      "name": "my-share-bind",
      "resource_type": "share_binding"
    }
  ],
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-65f30e48-3074-4eb0-9ec4-51ce2ec968eb/bindings?limit=20"
  },
  "limit": 50,
  "total_count": 1
}

Visualizzazione di un bind specifico di una condivisione file con l'API

Effettuare una richiesta GET /shares/{share_id}/bindings/{binding_id} per ottenere le informazioni di uno specifico bind di condivisione file. Questa richiesta recupera un singolo binding specificato dall'identificatore nell'URL.

curl -X GET "$vpc_api_endpoint/v1/shares/$share_id/bindings/$binding_id?version=2024-03-20&generation=2"\
-H "Authorization: $iam_token"

Una risposta corretta si presenta come nell'esempio seguente.

{
  "accessor": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
    "id": "r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
    "name": "my-accessor-share",
    "resource_type": "share"
  },
  "account": {
    "id": "a0000000000000000000000000000001",
    "resource_type": "account"
  },
  "created_at": "2022-01-07T16:56:54Z",
  "crn": "crn:[...]",
  "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r134-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r134-df760133-3513-47e7-b980-26cca666561b",
  "id": "r134-df760133-3513-47e7-b980-26cca666561b",
  "lifecycle_state": "stable",
  "name": "my-share-bind",
  "resource_type": "share_binding"
}

Elencare tutte le destinazioni di montaggio di una condivisione file con l'API

Effettuare una richiesta GET /shares/{share_id}/mount_targets per elencare tutte le destinazioni di montaggio di una condivisione file.

Vedi il seguente esempio.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets?version=2023-07-18?limit=50&generation=2"\
-H "Authorization: $iam_token"

Una risposta corretta si presenta come nell'esempio seguente:

{
  "first": {
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets?limit=50"
  },
  "limit": 50,
  "mount_targets": [
    {
      "access_control_mode": "security_group",
      "created_at": "2023-07-18T01:59:46.000Z",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets/r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "id": "r006-1b5571cb-536d-48d0-8452-81c05c6f7b80",
      "lifecycle_reasons": [],
      "lifecycle_state": "stable",
      "mount_path": "fsf-dal1099a-fz.adn.networklayer.com:/nxg_s_voll_mz0716_a4cc07a3_4425_4adf_aed6_0d7e142bee0c",
      "name": "my-target",
      "primary_ip": {
        "address": "192.0.2.0",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/35984145-9c3a-4626-8ee7-52c7a8742752/reserved_ips/0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
        "id": "0716-6fd4925d-7774-4e87-829e-7e5765d454ad",
        "name": "my-reserved-ip",
        "resource_type": "subnet_reserved_ip"
      },
      "resource_type": "share_mount_target",
      "security_groups": [
        {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
          "id": "r006-1dfeccef-3ad6-4760-8653-a202bc795db4",
          "name": "my-security-group",
          "resource_type": "security_group"
        }
      ],
      "subnet": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/35984145-9c3a-4626-8ee7-52c7a8742752",
        "id": "35984145-9c3a-4626-8ee7-52c7a8742752",
        "name": "my-subnet",
        "resource_type": "subnet"
      },
      "transit_encryption": "none",
      "virtual_network_interface": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/388f01db-41bb-42aa-b5cd-34ba41288d47",
        "id": "388f01db-41bb-42aa-b5cd-34ba41288d47",
        "name": "my-virtual-network-interface",
        "resource_type": "virtual_network_interface"
      },
      "vpc": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/4c0bb0df-5ca2-43ca-a3de-a4f86010a906",
        "id": "4c0bb0df-5ca2-43ca-a3de-a4f86010a906",
        "name": "my-vpc",
        "resource_type": "vpc"
      }
    }
  ],
  "total_count": 1
}

Visualizzazione di una singola destinazione di montaggio con l'API

Effettuare una richiesta GET /shares/{share_id}/mount_targets/{mount_target_id} alle informazioni di una singola destinazione di montaggio di una condivisione file. Questa chiamata include le informazioni sul percorso di montaggio. Utilizzare il percorso di montaggio per allegare una condivisione file a un'istanza.

Vedi il seguente esempio

curl -X GET \
"$vpc_api_endpoint/v1/shares/$share_id/mount_targets/$mount_target_id?version=2023-07-18&generation=2"\
-H "Authorization: $iam_token"

Una risposta corretta si presenta come nell'esempio seguente. In questo esempio, codifica dati in transito non è abilitato. Il valore della proprietà transit_encryption è provider_managed.

{
    "access_control_mode": "security_group",
    "created_at": "2023-07-18T01:59:46.000Z",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares//199d78ec-b971-4a5c-a904-8f37ae710c63/mount_targets/d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
    "id": "d5fd8173-f519-4ff7-8f63-0ead23ecf1f4",
    "lifecycle_reasons": [],
    "lifecycle_state": "stable",
    "mount_path": "fsf-dal1099a-fz.adn.networklayer.com:/nxg_s_vol_xyz_2891fd0a_64ea_4deb_9ed5_1159e37cb5aa",
    "name": "my-mount-target2",
    "primary_ip": {
      "address": "192.0.2.0",
      "href": "https://us-south.iaas.cloud.ibm.com/subnets/c2338e66-dcb5-4e9b-b572-108d47ca479a/reserved_ips/b96d456e-88f7-42a7-b02d-450a6d758534",
      "id": "b96d456e-88f7-42a7-b02d-450a6d758534",
      "name": "my-reserved-ip",
      "resource_type": "subnet_reserved_ip"
    },
    "resource_type": "share_mount_target",
    "security_groups": [
      {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/security_groups/b79365be-f626-45d4-94ae-83f16fa4edd3",
        "id": "b79365be-f626-45d4-94ae-83f16fa4edd3",
        "name": "my-security-group",
        "resource_type": "security_group"
      }
    ],
    "subnet": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/subnets/c2338e66-dcb5-4e9b-b572-108d47ca479a",
      "id": "c2338e66-dcb5-4e9b-b572-108d47ca479a",
      "name": "my-subnet",
      "resource_type": "subnet"
    },
    "transit_encryption": "provider_managed",
    "virtual_network_interface": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/virtual_network_interfaces/4551a68d-b45d-4443-b6b3-aba7a4a18c98",
      "id": "4551a68d-b45d-4443-b6b3-aba7a4a18c98",
      "name": "my-virtual-network-interface",
      "resource_type": "virtual_network_interface"
    },
    "vpc": {
      "crn": "crn:[...]",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/5821d0c4-a089-4957-b5fa-03b7ac636c15",
      "id": "5821d0c4-a089-4957-b5fa-03b7ac636c15",
      "name": "my-vpc",
      "resource_type": "vpc"
    }
  }

Visualizzazione di una condivisione file di origine per una condivisione file di replica con l'API

Effettuare una richiesta GET /shares/{replica_id}/source e specificare l'ID condivisione replica per richiamare i dettagli della condivisione file di origine.

curl -X GET \
"$vpc_api_endpoint/v1/shares/$replica_id/source?version=2023-07-18&generation=2"\
-H "Authorization: $iam_token"\

Una risposta corretta fornisce i dettagli della condivisione file di origine. Si noti che il ruolo di replica è source.

{
    "access_control_mode": "security_group",
    "created_at": "2023-07-18T22:58:49.000Z",
    "crn": "crn:[...]",
    "encryption": "provider_managed",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/207721a9-aff9-4b16-9823-fe68096aeac3",
    "id": "207721a9-aff9-4b16-9823-fe68096aeac3",
    "iops": 14400,
    "lifecycle_state": "stable",
    "mount_targets": [
      {
        "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/207721a9-aff9-4b16-9823-fe68096aeac3/mount_targets/ce244454-0919-45e2-b14b-f4285afcd856",
        "id": "ce244454-0919-45e2-b14b-f4285afcd856",
        "name": "my-share-mount-target",
        "resource_type": "share_mount_target",
        "vpc": {
          "crn": "crn:[...]",
          "href": "https://us-south.iaas.cloud.ibm.com/v1/vpcs/c8b8fa2d-ccf7-4f42-9d38-df6d123c867d",
          "id": "c8b8fa2d-ccf7-4f42-9d38-df6d123c867d",
          "name": "my-vpc",
          "resource_type": "vpc"
        }
      }
    ],
    "name": "my-share-3",
    "profile": {
      "family": "defined-performance",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/dp2",
      "name": "dp2",
      "resource_type": "share_profile"
    },
    "replication_role": "source",
    "replication_status": "active",
    "replication_status_reasons": [],
    "resource_group": {
      "crn": "crn:[...]",
      "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/678523bcbe2b4eada915d32640909956",
      "id": "678523bcbe2b4eada915d32640909956",
      "name": "Default"
    },
    "resource_type": "share",
    "size": 4800,
    "snapshot_count": 10,
    "snapshot_size": 10,
    "user_tags": [],
    "zone": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-1",
      "name": "us-south-1",
      "resource_type": "zone"
    }
  }

Visualizzazione delle condivisioni file e delle destinazioni di montaggio con Terraform

Puoi utilizzare Terraform per visualizzare informazioni sulla tua condivisione file e sulle tue destinazioni di montaggio.

Per utilizzare Terraform, scarica la CLI Terraform e configura il plug-in del provider IBM Cloud. Per ulteriori informazioni, vedi Introduzione a Terraform.

I servizi dell'infrastruttura VPC utilizzano uno specifico endpoint regionale, che per impostazione predefinita punta a us-south. Se il tuo VPC viene creato in un'altra regione, assicurati di specificare la regione appropriata nel blocco del provider nel file provider.tf.

Vedi il seguente esempio di destinazione di una regione diversa da quella predefinita us-south.

provider "ibm" {
  region = "eu-de"
}

Visualizzazione di tutte le condivisioni file con Terraform

Importare l'elenco di condivisioni file che appartengono a un account come origine dati di sola lettura. È possibile filtrare in base al nome condivisione o all'ID gruppo di risorse.

data "ibm_is_shares" "example" {
}

Gli attributi esportati includono il conteggio totale delle condivisioni e l'elenco delle condivisioni. Gli attributi nidificati includono ID condivisione, nome, data di creazione, dimensione, IOPS, CRN, tag di accesso, chiave e tipo di crittografia, stato del ciclo di vita, stato e ruolo di replica, destinazione di montaggio e altri attributi.

Per ulteriori informazioni, consultare ibm_is_shares.

Visualizzazione delle informazioni di condivisione file con Terraform

Importare i dettagli di una condivisione file come origine dati di sola lettura. È necessario identificare la condivisione per ID o nome.

data "ibm_is_share" "example" {
  share = ibm_is_share.example.id
}

data "ibm_is_share" "example1" {
  name = ibm_is_share.example.name
}

Gli attributi esportati includono ID, nome, data di creazione, dimensione, IOPS, CRN, tag di accesso, tipo di codifica, chiave di codifica, stato del ciclo di vita, stato e ruolo di replica, destinazione di montaggio e altri attributi.

Per ulteriori informazioni, consultare ibm_is_share.

Visualizzazione delle destinazioni di montaggio associate a una condivisione file con Terraform

Importare l'elenco di destinazioni di montaggio associate a una condivisione file come origine dati di sola lettura. Identificare la condivisione file in base al suo ID.

data "ibm_is_share_targets" "example" {
  share = ibm_is_share.example.id
}

Gli attributi esportati includono l'elenco di destinazioni di montaggio e i relativi ID, nomi, data di creazione, percorsi di montaggio, informazioni sulla sottorete e così via.

Per ulteriori informazioni, vedi ibm_is_share_targets.

Visualizzazione delle informazioni sulla destinazione di montaggio con Terraform

Importare i dettagli di una destinazione di montaggio come origine dati di sola lettura. Identificare la destinazione di montaggio specificando l'ID condivisione e l'ID destinazione di montaggio. Entrambi gli argomenti sono obbligatori.

data "ibm_is_share_target" "example" {
  share        = ibm_is_share.example.id
  share_target = ibm_is_share_target.example.share_target
}

Gli attributi esportati includono ID, nome, data di creazione, percorso di montaggio, informazioni sulla sottorete e altri attributi.

Per ulteriori informazioni, vedi ibm_is_share_target.

Passi successivi

Montare le condivisioni file. Il montaggio è un processo con cui il sistema operativo di un server rende i file e le directory sul dispositivo di archiviazione disponibili per l'accesso da parte degli utenti attraverso il file system del server. Per ulteriori informazioni, vedi i seguenti argomenti:

Gestire le condivisioni file e i dati.

  • Gestire le condivisioni file. È possibile ridenominare una condivisione file. Puoi aumentare la sua capacità e modificare il suo IOPS. È possibile aggiungere destinazioni di montaggio a una condivisione file. È possibile ridenominare o eliminare una destinazione di montaggio. È possibile eliminare una condivisione file quando non è più necessaria.
  • Creare una condivisione file con la replica. Con la funzione di replica, è possibile mantenere una copia di sola lettura della condivisione file in un'altra zona. La condivisione di replica viene aggiornata dalla condivisione di origine in base a una pianificazione specificata. La replica fornisce un modo per eseguire il ripristino da un incidente nel sito primario, quando i dati diventano inaccessibili o un'applicazione non riesce. La replica può essere utilizzata anche per l'espansione geografica.