Anzeigen von Dateifreigaben, Freigabeverknüpfungen und Einhängezielen

Zeigen Sie „ File Storage for VPC “-Freigaben, Zugriffsberechtigungen für Freigaben und Einhängeziele über die Konsole, die Befehlszeile, die API oder Terraform an.

Anzeige von Dateifreigaben, Freigabeverknüpfungen und Einhängezielen in der Konsole

Anzeige aller Dateifreigaben in der Konsole

  1. Klicken Sie in der Konsole IBM Cloud auf das Symbol Navigation > Infrastruktur VPC > Storage > File Storage Shares.

  2. Auf der Listenseite Dateifreigaben für VPC werden alle Dateifreigaben angezeigt, die in dieser Zone erstellt wurden. Im Menü Aktionen Aktionssymbol werden Optionen für die Verwaltung der Dateifreigaben verwendet. Die folgende Tabelle beschreibt die Informationen auf der Listenseite.

Seite mit der Liste der Dateifreigaben.
Feld Wert
Bereich Die Kontoregion für die Dateifreigabe. Wählen Sie eine andere Region aus, um die Dateifreigaben für Zonen in dieser Region zu prüfen.
Name Der Name der Dateifreigabe. Dies kann die ursprüngliche Dateifreigabe oder eine Replikatdateifreigabe sein. Klicken Sie auf den Namen, um Details zu dieser Dateifreigabe anzuzeigen.
Status Eine Liste der Status für Dateifreigaben finden Sie unter Lebenszyklusstatus von Dateifreigaben.
Ressourcengruppe In diesem Feld wird der Name der Ressourcengruppe angezeigt, zu der die Dateifreigabe gehört.
Standort In diesem Feld wird die Zone angezeigt, in der sich die Dateifreigabe befindet.
Mountziele Die Anzahl der Mountziele, die der Dateifreigabe zugeordnet sind. Sie können ein Mountziel pro VPC und Dateifreigabe haben.
Snapshots In diesem Feld wird die Anzahl der Snapshots angezeigt, die von der Dateifreigabe erstellt wurden. Diese Spalte ist standardmäßig ausgeblendet. Klicken Sie auf das Symbol Einstellungen, um auszuwählen, welche Spalten Sie sehen möchten.
Größe Die Größe der Dateifreigabe in GB.
Kontenübergreifende Rolle Die Werte in dieser Spalte können None, Origin share, oder Accessor share sein. Wenn der Wert None lautet, wird die Freigabe nicht für ein anderes Konto oder einen externen Dienst freigegeben. Wenn der Wert Origin share lautet, wird die Freigabe mit einem anderen Konto oder externen Dienst geteilt und ist an eine Zugriffsfreigabe im anderen Konto gebunden. Ist der Wert Accessor share, dann ist diese Freigabe an eine Ursprungsfreigabe gebunden, um auf die Daten der Ursprungsfreigabe zuzugreifen.
Replikationsrolle Beziehung zwischen der Quelle und der Dateifreigabe des Replikats. Replik von bedeutet, dass die Dateifreigabe eine Replik der Quellfreigabe ist, auf die verwiesen wird. Quelle von bedeutet, dass die Quelle der Replik, auf die verwiesen wird, gemeinsam genutzt wird. "None" gibt an, dass die Dateifreigabe nicht mit einer anderen Freigabe repliziert wird.
Replikationsstatus Diese Spalte ist standardmäßig ausgeblendet. Klicken Sie auf das Symbol Einstellungen, um auszuwählen, welche Spalten Sie sehen möchten.
Verschlüsselungs­typ Hier wird die Verschlüsselungsart der Dateifreigabe angezeigt, entweder vom Anbieter verwaltet oder vom Kunden verwaltet. Vom Kunden verwaltete Verschlüsselung verwendet eigene Rootschlüssel zum Schutz Ihrer Daten. Die Benutzeroberfläche identifiziert außerdem den Schlüsselverwaltungsdienst (KMS).

Sie können auf das Menü "Aktionen" zugreifen, indem Sie auf Aktionssymbol klicken. Das Menü 'Aktionen' enthält je nach Status Optionen für die Verwaltung der Dateifreigabe.

  • Bei einer zonalen Dateifreigabe in einem stabilen Zustand können Sie die Freigabe umbenennen, IOPS bearbeiten, die CRN der Freigabe kopieren, ein Replikat erstellen oder die Dateifreigabe löschen. Die Aktionen Replik löschen und Replik erstellen sind deaktiviert, wenn Sie bereits eine Replikation zu einer Replik-Dateifreigabe eingerichtet haben. Weitere Informationen finden Sie unter Replikatdateifreigaben erstellen.
  • Für eine regionale Dateifreigabe enthält das Menü "Aktionen" die Aktionen Umbenennen, Größe und Bandbreite bearbeiten, CRN kopieren, Snapshot erstellen und Löschen.

Details zu einer Dateifreigabe in der Konsole anzeigen

  1. Rufen Sie die Liste aller Dateifreigaben auf. Klicken Sie in der Konsole IBM Cloud auf das Symbol Navigation > Infrastruktur VPC > Storage > File Storage Shares.

  2. Klicken Sie auf den Namen einer Dateifreigabe, um die Detailseite anzuzeigen. Der bearbeitbare Name und der Status der Dateifreigabe werden angezeigt. Wenn Sie der Dateifreigabe Benutzer- oder Zugriffsverwaltungs-Tags zugewiesen haben, werden diese neben dem Status aufgeführt. Klicken Sie auf Tags hinzufügen, um neue Tags auf die Freigabe anzuwenden.

  3. Die Detailseite enthält mehrere Registerkarten. Standardmäßig wird die Registerkarte Übersicht angezeigt.

    • Übersicht- Die folgende Tabelle beschreibt die Informationen, die für Ihre Dateifreigabe verfügbar sind.
    Detailseite der Dateifreigaben
    Feld Wert
    Dateifreigabedetails
    Name Der Name der Dateifreigabe. Klicken Sie auf das Symbol Bearbeiten Bearbeitungssymbol, um den Namen zu ändern.
    Dateifreigabe-ID Die UUID, die beim Erstellen der Dateifreigabe generiert wurde.
    Ressourcengruppe Die Ressourcengruppen, die der Dateifreigabe in Ihrem Konto zugeordnet sind.
    Erstellungsdatum Der Zeitpunkt, zu dem die Dateifreigabe erstellt wurde.
    Standort Der Speicherort der Dateifreigabe (z. B. us-south-2 ).
    Replikationsrolle Quellendateifreigabe oder Replikat.
    Verschlüsselung Gibt die vom Provider verwaltete oder vom Kunden verwaltete Verschlüsselung an Wenn die Dateifreigabe mit vom Kunden verwalteten Schlüsseln verschlüsselt ist, werden auch die Verschlüsselungsinstanz, der Name des Verschlüsselungsschlüssels und die CRN des Verschlüsselungsschlüssels angezeigt.
    Zugriffsmodus für das Einbinden von Zielen „
    “ – veraltet    		 Dieses Feld wird nur angezeigt, wenn die Dateifreigabe über den veralteten VPC-Zugriffsmodus verfügt. Klicken Sie auf das Symbol „Bearbeiten“ Symbol „Bearbeiten“, um den Zugriffsmodus zu wechseln. Weitere Informationen finden Sie im Migrationsleitfaden.
    CRN Der kopierbare Cloud Resource Name der Dateifreigabe.
    Zulässige Verschlüsselung im Übertragungsmodus Dieser Wert gibt an, ob eine Verschlüsselung während der Übertragung erforderlich ist, wenn Clients auf die Dateifreigabe zugreifen. Klicken Sie auf das Symbol Bearbeiten Bearbeitungssymbol, um die zulässigen Werte zu ändern. Die möglichen Werte sind User managed, und None. Dieses Feld ist für Dateifreigaben mit dem veralteten VPC-Zugriffsmodus nicht relevant.
    Wählen Sie die Verfügbarkeits. Kunden mit speziellem Zugriff auf die Vorschau des neuen regionalen Dateifreigabeangebots können zwischen „IPsec“, „Stunnel“ und „Keine“ wählen.
    Kontenübergreifende Rolle Die möglichen Werte sind None, Origin, Accessor. Dieses Feld ist für Dateifreigaben mit dem veralteten VPC-Zugriffsmodus nicht relevant.
    Snapshot-Anzahl Dieser Wert gibt die Anzahl der Snapshots an, die von der Dateifreigabe erstellt wurden. Dieses Feld ist für Dateifreigaben mit dem veralteten VPC-Zugriffsmodus nicht relevant.
    Umfang der geänderten Daten in allen Snapshots Sie stellt das abrechenbare Datenvolumen über alle Snapshots hinweg dar. Dieses Feld ist für Dateifreigaben mit dem veralteten VPC-Zugriffsmodus nicht relevant.
    Profildetails
    Profil Der Name des Freigabeprofils, das die Leistung der Dateifreigabe definiert. In den meisten Fällen ist das Profil dp2.
    Größe Speicherkapazität für die Dateifreigabe in GB.
    Max. E/A-Operationen pro Sekunde Maximale IOPS für die angegebene Freigabe. Dieses Feld wird für zonale Anteile angezeigt.
    Bandbreite Die maximale Bandbreite, die für die Freigabe angegeben ist. Dieses Feld wird für regionale Aktien angezeigt.
    Mountziele Die Anzahl der Mountziele, die der Dateifreigabe zugeordnet sind. Sie können ein Mountziel pro VPC und Dateifreigabe haben. Sie können mehrere Mountziele für andere VPCs erstellen. Klicken Sie auf Aktionssymbol, um das Mountziel umzubenennen oder zu löschen oder um den Mountpfad anzuzeigen.
    Name Der Name des Mountziels.
    Status Der Status des Mountziels in der VPC.
    Virtual Private Cloud-
    t veraltet    		 Dieses Feld wird angezeigt, wenn die Dateifreigabe über den veralteten VPC-Zugriffsmodus verfügt. Klicken Sie auf den Namen, um zur Detailseite dieser VPC zu gelangen, auf der Sie eine Liste der Dateifreigaben sehen können, die ein Einhängeziel in dieser VPC haben.
    Teilnetz Dieses Feld wird angezeigt, wenn die Dateifreigabe den Zugriffsmodus Sicherheitsgruppe hat. Klicken Sie auf den Namen des Subnetzes, um dessen Details anzuzeigen.
    Sicherheitsgruppe Dieses Feld wird angezeigt, wenn die Dateifreigabe den Zugriffsmodus Sicherheitsgruppe hat. Die Anzahl der Sicherheitsgruppen, zu denen die Freigabe gehört.
    Reservierte IP Dieses Feld wird angezeigt, wenn die Dateifreigabe den Zugriffsmodus Sicherheitsgruppe hat. Die IP-Adresse der virtuellen Netzschnittstelle, die dem Mountziel zugeordnet ist.
    Verschlüsselung in Transit Dieses Feld wird angezeigt, wenn die Dateifreigabe den Zugriffsmodus Sicherheitsgruppe hat. Diese Funktion kann aktiviert oder deaktiviert werden.
    Bindungen zu Freigaben für Zugriffsberechtigte Dieser Abschnitt wird angezeigt, wenn die Ressource Zugriffsrechte auf Ressourcen in anderen VPCs besitzt.
    Bindungs-ID Dieses Feld zeigt die ID der Bindung an, die die ursprüngliche Freigabe mit der Zugriffsobjektfreigabe verbindet.
    Konto-ID Die ID des Kontos, das über die Zugriffsberechtigtenfreigabe Zugriff auf die Daten Ihrer Freigabe hat.
    Zugriffsmechanismus-ID In diesem Feld wird die Konto-ID angezeigt, die die Zugriffsberechtigtenfreigabe in einer anderen VPC erstellt hat.
    Status Es zeigt den Lebenszyklusstatus der Dateifreigabe des Zugriffsmechanismus an. Der Status Stable wird erwartet.
    Erstellungsdatum Datum und Uhrzeit der Erstellung des Zugriffsrechts.
    Replikationsbeziehung für Dateifreigabe

    Zeigt den Namen, die Position und den Status der Quellen-und Replikatdateifreigaben an.

    • Wenn keine Replikatdateifreigaben erstellt wurden, klicken Sie auf Replik erstellen, um eine Replik zu erstellen.
    • Um die Replikationsbeziehung zu unterbrechen, klicken Sie auf Replikationsbeziehung entfernen. Anschließend wird die Replikatdateifreigabe zu einer unabhängigen Dateifreigabe mit Schreib-/Lesezugriff.
    Replikationsfrequenz Bewegen Sie den Mauszeiger über das Informationssymbol, um eine Erläuterung zum Cron-Replikationszeitplan anzuzeigen.
    Status Replikationsstatus, z. B. Ausgesetzt oder Verfügbar.
    Startzeit der letzten Synchronisation Der Zeitpunkt (Datum und Uhrzeit), zu dem die letzte Replikation gestartet wurde.
    Fertigstellungszeit der letzten Synchronisation Datum und Uhrzeit des Abschlusses der letzten Replikation.
    Übertragungsrate Es zeigt die Geschwindigkeit an, mit der Daten während der letzten Synchronisation aus der Quellendateifreigabe in ihr Replikat kopiert wurden.
    Überweisungsbetrag Das Datenvolumen, das während der letzten Synchronisation aus der Quellendateifreigabe in ihr Replikat kopiert wurde.
    Replikationsrolle Quellen- oder Replikatdateifreigabe.
    Name der Dateifreigabe Klicken Sie auf den Namen der Dateifreigabe, um die zugehörigen Details anzuzeigen.
    Standort Zeigt die Zoneninformationen der Dateifreigabe an.
    Status Es zeigt den Lebenszyklusstatus der Dateifreigabe an. Der Status Stable wird erwartet.

    • Snapshots – Auf der Registerkarte „Snapshots“ finden Sie eine Übersicht über alle Snapshots sowie eine Liste der Snapshots, die von der Dateifreigabe erstellt wurden.

      • Die Snapshot-Zusammenfassung enthält Informationen wie die Anzahl der Snapshots, das in den Snapshots erfasste Gesamtdatenvolumen und die Replikationsrolle.
      • Die Liste Snapshots zeigt die Snapshots, die von der Dateifreigabe erstellt wurden. Sie können den Namen, die Größe der Dateifreigabe zum Zeitpunkt der Erstellung des Snapshots und den Status des Snapshots sehen. Sie können auf Erstellen klicken, um einen neuen Schnappschuss zu erstellen. Klicken Sie auf das Symbol Aktionen um das Menü Aktionen anzuzeigen. Das Menü "Aktionen" enthält 2 Optionen: Wiederherstellen und Löschen.

    • Überwachung- Auf der Registerkarte Überwachung sehen Sie drei Diagramme für die gemeinsame Nutzung, die Gesamtbandbreite und die Gesamt-IOPS. Diese Diagramme stehen Ihnen kostenlos zur Verfügung, auch ohne eine IBM Cloud Monitoring. Sie können den Datumsbereich anpassen, um Daten im Zeitverlauf anzuzeigen.

      Durch die Überwachung dieser Auslastungsmetriken können Sie feststellen, wie viel Arbeit von Ihrer Anwendung oder Ihrem Workload geleistet wird. Anhand dieser Informationen können Sie feststellen, ob der IOPS-Wert angepasst werden muss. Die Überwachung der verfügbaren Kapazität Ihrer Freigabe kann Ihnen helfen, den Bedarf an mehr Speicherplatz zu erkennen, bevor unzureichender Speicherplatz zu einem Problem beim Schreiben von Daten auf die Freigabe oder bei der Replikation wird. Anhand dieser Metriken können Sie etwaige Gebührenänderungen am Ende des Abrechnungszeitraums vorhersehen.

      Diese Metriken werden nicht in Echtzeit aktualisiert. Es kann bis zu einer Stunde oder einer Stunde und 15 Minuten dauern, bis die Daten für neue Dateifreigaben in den Diagrammen der Konsole erscheinen. Es kann 15 bis 30 Minuten dauern, bis sich Änderungen in der Nutzung in den Diagrammen niederschlagen.

      Wenn Sie eine Instanz des IBM Cloud Monitoring-Dienstes haben, klicken Sie auf Überwachung starten, um die Sysdig-Web-UI zu öffnen und dort mit den Metrik-Dashboards zu arbeiten. Weitere Informationen zur Einrichtung der IBM Cloud Monitoring-Instanz finden Sie unter Überwachung von Metriken für File Storage for VPC.

Alle Dateifreigaben für eine VPC in der Konsole anzeigen

Sie können alle Dateifreigaben, die ein Mountziel für eine VPC haben, auf der VPC-Detailseite anzeigen.

  1. Navigieren Sie zu einer VPC:

    1. Klicken Sie auf der Seite für Dateifreigabedetails auf den VPC-Link in der Liste der Mountziele.
    2. Klicken Sie in der Benutzeroberfläche auf das Symbol Navigationsmenü Menü-Symbol > Infrastruktur VPC-Symbol > Netzwerk > VPCs. Klicken Sie in der Liste auf den Namen einer VPC.

  2. Blättern Sie auf der VPC-Detailseite zu Dateifreigaben in dieser VPC.

Anzeigen von Details zum Einhängeziel in der Konsole

  1. Rufen Sie die Liste aller Dateifreigaben auf. Klicken Sie in der Konsole IBM Cloud auf das Symbol Navigation > Infrastruktur VPC > Storage > File Storage Shares.
  2. Klicken Sie auf den Namen einer Dateifreigabe, um die Detailseite anzuzeigen.
  3. Blättern Sie zum Abschnitt "Mountziele", um die Liste der Mountziele anzuzeigen. Die Liste enthält die Namen und Status des Mountziels und die VPC, zu der das Mountziel gehört.
  4. Klicken Sie auf das Symbol Aktionen um das Menü Aktionen anzuzeigen. Das Menü "Aktionen" enthält drei Optionen: Umbenennen, Pfad anzeigen und Löschen.
  5. Klicken Sie auf Pfad anzeigen, um die Mountpfadinformationen anzuzeigen, die Sie kopieren und in Ihre Mountbefehle einfügen können.

Dateifreigaben, gemeinsam genutzte Bindungen und Mountziele über die Befehlszeilenschnittstelle anzeigen

Bevor Sie die Befehlszeilenschnittstelle (CLI) verwenden können, müssen Sie die IBM Cloud-CLI und das VPC-CLI-Plug-in installieren. Weitere Informationen finden Sie unter CLI-Voraussetzungen.

Alle Dateifreigaben über die Befehlszeilenschnittstelle anzeigen

Sie können alle Dateifreigaben in einer Region mit dem Befehl ibmcloud is shares auflisten.

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   Allowed Access Protocols   Availability Mode   Bandwidth(Mbps)   Storage Generation
r006-6cedac18-ffe5-4a89-9e7a-5c8683d17279   my-regional-file-share   stable            -            rfs       1000        defaults         none               none                    0                0               -                          regional            1500              2
r006-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share     stable            us-south-2   dp2       10         defaults         source             none                    2                1               -                          zonal               -                 1
r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-file-share    stable            us-south-1   dp2       10         defaults         replica            none                    2                1               -                          zonal               -                 1
r006-ee1f6fc0-6fa3-4821-ad70-f6589e30c566   my-accessor-share        stable            -           rfs        3000         defaults         none               accessor                0                0               -                          regional            1                 2
r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09   my-origin-share          stable            -           rfs        3000        defaults         none               origin                  0                0               -                          regional            1                 2

Weitere Informationen zu den Befehlsoptionen finden Sie unter ibmcloud is shares. Weitere Informationen zu lifecycle state finden Sie unter Dateifreigabestatus. Stable wird erwartet.

Anzeigen der Details einer Dateifreigabe über die Befehlszeilenschnittstelle (CLI)

Um die Details einer Dateifreigabe anzuzeigen, führen Sie den Befehl ibmcloud is share aus und geben Sie die Dateifreigabe nach ID oder Name an.

Im folgenden Beispiel wird die Dateifreigabe anhand ihrer ID identifiziert. Diese Freigabe ist eine Replik, die auf dem dp2-Profil basiert, und der Zugriff auf die Freigabe wird mithilfe von Sicherheitsgruppen erteilt. Die Ausgabe enthält auch Informationen zur Quellendateifreigabe und zu den Replikationsdetails.

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-file-share
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,ipsec
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-e4acfa9b-88b0-4f90-9320-537e6fa3482a   my-source-file-share    share
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nfs4
Availability Mode                  zonal
Bandwidth(Mbps)                    1
Storage Generation                 1

Sie können den Namen der Quellenfreigabe verwenden, um die zugehörigen Details abzurufen. Beispiel:

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 ipsec,none
Zone                             us-south-2
Profile                          dp2
Size(GB)                         10
IOPS                             100
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
                                 6edefe513d934fdd872e78ee6a8e73ef   defaults
Created                          2024-06-25T15:42:53+00:00
Latest job                       Job status   Job status reasons
                                 succeeded    -
Replication share                ID                                          Name                    Resource type
                                 r006-455b601c-8fc1-4476-8771-4708c49c8ef7   my-replica-file-share   share
Replication role                 source
Replication status               active
Replication status reasons       Status code   Status message
                                 -             -
Snapshot count                   0
Snapshot size                    0
Source snapshot                  -
Allowed Access Protocols         nfs4
Availability Mode                zonal
Bandwidth(Mbps)                  1
Storage Generation               1

Das folgende Beispiel zeigt die Informationen, die der Befehl ibmcloud is share zurückgibt, wenn Sie Informationen über eine regionale Dateifreigabe abrufen.

ibmcloud is share my-regional-file-share

Getting file share my-file-share under account Test Account as user test.user@ibm.com...
ID                                 r006-6cedac18-ffe5-4a89-9e7a-5c8683d17279
Name                               my-regional-file-share
CRN                                crn:v1:bluemix:public:is:us-south-2:a/a1234567::share:r006-6cedac18-ffe5-4a89-9e7a-5c8683d17279
Lifecycle state                    stable
Access control mode                security_group
Accessor binding role              none
Allowed transit encryption modes   stunnel,none
Zone                               -
Profile                            rfs
Size(GB)                           1000
IOPS                               35000
Encryption                         provider_managed
Mount Targets                      ID                       Name
                                   No mounted targets found
Resource group                     ID                                 Name
                                   db8e8d865a83e0aae03f25a492c5b39e   Default
Created                            2025-07-22T22:15:15+00:00
Replication role                   none
Replication status                 none
Replication status reasons         Status code   Status message
                                   -             -
Snapshot count                     0
Snapshot size                      0
Source snapshot                    -
Allowed Access Protocols           nsf4
Availability Mode                  regional
Bandwidth(Mbps)                    125
Storage Generation                 2

Weitere Informationen zu den Befehlsoptionen finden Sie unter ibmcloud is share.

Freigegebene Bindungen einer Dateifreigabe über die Befehlszeilenschnittstelle anzeigen

Um die mit einer Ursprungsfreigabe verknüpften Accessor-Freigabebindungen über die CLI anzuzeigen, verwenden Sie den Befehl ibmcloud is share-accessor-bindings. Beispiel:

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                                                                                                    Accessor resource type
r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f   stable            2025-08-26T21:03:40+00:00   crn:v1:bluemix:public:is::a/a1234567::share:r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09   share
Viktoria_Muirhead@cloudshell:~$

Bestimmte Freigabebindung einer Dateifreigabe über die Befehlszeilenschnittstelle anzeigen

Um eine bestimmte Accessor-Freigabebindung, die mit einer Ursprungsfreigabe verknüpft ist, über die CLI anzuzeigen, verwenden Sie den Befehl ibmcloud is share-accessor-binding. Beispiel:

ibmcloud is share-accessor-binding my-origin-share r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f

Get accessor binding r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f for the share ID my-origin-share under account Test Account as user test.user@ibm.com...
ID                r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f
Created           2025-08-26T21:03:40+00:00
Href              https://us-south.iaas.cloud.ibm.com/v1/shares/r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09/accessor_bindings/r006-b5707b7b-1ac7-48c9-8fc3-4ba65b91e36f
Resource type     share_accessor_binding
Lifecycle state   stable
Accessor          Resource type   CRN                                                                                                             Name
                  share           crn:v1:bluemix:public:is::a/a1234567::share:r006-fdd5774c-fe8a-41f4-9088-eafc89f58c09      my-accessor-share

Anzeigen von Einhängezielen für eine Dateifreigabe über die Befehlszeile

Führen Sie den Befehl ibmcloud is share-mount-targets aus und geben Sie die Dateifreigabe-ID an, um alle Mountziele anzuzeigen, die für eine Dateifreigabe erstellt wurden.

ibmcloud is share-mount-targets r006-e1a89008-f23b-42f8-8e44-5b31ddf0aac7

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

Weitere Informationen zu den Befehlsoptionen finden Sie unter ibmcloud is share-mount-targets.

Details zum Mountziel über die Befehlszeilenschnittstelle anzeigen

Um detailliertere Informationen zu einem Mountziel anzuzeigen, führen Sie den Befehl ibmcloud is share-mount-target aus und geben Sie die gemeinsam genutzte ID oder den Namen mit dem Namen oder der ID des Mountzielnamens an. Beispiel:

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

Weitere Informationen zu den Befehlsoptionen finden Sie unter ibmcloud is share-mount-target.

Dateifreigaben, gemeinsam genutzte Bindungen und Mountziele mit der API anzeigen

Sie können Freigaben und Mountziele programmgesteuert anzeigen, indem Sie die Methode /shares in der VPC-API aufrufen, wie in den folgenden Beispielanforderungen gezeigt.

Sie müssen den Parameter generation und generation=2 angeben. Weitere Informationen finden Sie unter Generation in der Referenz zur Virtual Private Cloud-API.

Replikationsstatus und lifecycle_state mit der API anzeigen

  • lifecycle_state
    • Diese Eigenschaft gibt den aktuellen Status einer Ressource über die Methode Dateifreigabe abrufen an. Die von lifecycle_state bereitgestellten Werte sind generisch und sollen für verschiedene Ressourcen gelten, nicht nur für Dateifreigaben. lifecycle_state gibt an, ob die Dateifreigabe stabil ist, gerade aktualisiert wird, gelöscht wird oder ausgesetzt ist. Stable wird erwartet. Weitere Informationen finden Sie unter Dateifreigabestatus.
  • replication_status
    • Diese Eigenschaft stellt den aktuellen Replikationsstatus der Datei über die Methode Dateifreigabe abrufen bereit. Die von replication_status zurückgegebenen Werte sind für Dateifreigaben spezifisch. Weitere Informationen finden Sie in den Inhalten zur Virtual Private Cloud-API.

Alle Dateifreigaben über die API anzeigen

Erstellen Sie eine Anforderung GET /shares, um alle Dateifreigaben für eine Region aufzulisten.

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

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus.

{
  "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"
      }
    }
  ]
}

Im Beispiel gibt der Abfrageparameter " limit eine Grenze von 50 Dateifreigaben an, obwohl die Beispielantwort nur eine enthält. Der Eigenschaftswert access_control_mode ist vpc, d. h., die Dateifreigabe kann an alle virtuellen Serverinstanzen in einer VPC angehängt werden. Dieser Zugriffskontrollmodus ist veraltet. Folgen Sie der Migrationsanleitung, um den Zugriffskontrollmodus Ihrer Freigabe auf security-group zu aktualisieren.

Anzeigen einer einzelnen Dateifreigabe über die API

Erstellen Sie eine Anforderung GET /shares/{share_id}, um Details zu einer einzelnen Dateifreigabe abzurufen.

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

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus. In diesem Beispiel wurde die Freigabe mit dem Profil " dp2 erstellt. Der Wert der Eigenschaft access_ control_mode ist security_group, d. h., dass der Zugriff auf die Freigabe durch die Regeln einer Sicherheitsgruppe bestimmt wird.

{
  "access_control_mode": "security_group",
  "accessor_binding_role": "none",
  "accessor_bindings": [],
  "allowed_access_protocol": "nsf4",
  "allowed_transit_encryption_modes": [
      "none",
      "ipsec"
  ],
  "availability_mode": "zonal",
  "bandwidth": 100,
  "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,
  "storage_generation": 1,
  "user_tags": [],
  "zone": {
      "href": "https://us-south.iaas.cloud.ibm.com/v1/regions/us-south/zones/us-south-2",
      "name": "us-south-2"
  }
}

Das folgende Beispiel zeigt die Antwort, die zurückgegeben wird, wenn Sie Informationen zu einer regionalen Datei mit der API abrufen.

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

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus:

{
  "access_control_mode": "security_group",
  "accessor_binding_role": "none",
  "accessor_bindings": [],
  "allowed_access_protocol": "nsf4",
  "allowed_transit_encryption_modes": [
      "none",
      "stunnel"
  ],
  "availability_mode": "regional",
  "bandwidth": 100,
  "created_at": "2025-06-24T09:17:14.000Z",
  "crn": "crn:v1:bluemix:public:is:us-south:a/a1234567::share:r006-4dadac27-cd17-42df-a5fe-1388705d33f1",
  "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-1388705d33ef1",
  "iops": 100,
  "latest_job": {
      "status": "succeeded",
      "status_reasons": [],
      "type": "replication_init"
  },
  "lifecycle_reasons": [],
  "lifecycle_state": "stable",
  "mount_targets": [],
  "name": "my-regional-share-us-south",
  "profile": {
      "family": "defined_performance",
      "href": "https://us-south.iaas.cloud.ibm.com/v1/share/profiles/rfs",
      "name": "rfs",
      "resource_type": "share_profile"
    },
    "resource_group": {
        "href": "https://resource-controller.cloud.ibm.com/v2/resource_groups/6edefe513d934fdd872e78ee6a8e73ef",
        "id": "6edefe513d934fdd872e78ee6a8e73ef",
        "name": "defaults"
    },
    "resource_type": "share",
    "size": 100,
    "snapshot_count": 0,
    "snapshot_size": 0,
    "storage_generation": 2,
    "user_tags": []
}

Gemeinsam genutzte Bindungen einer Dateifreigabe mit der API auflisten

Erstellen Sie eine GET /shares/{id}/bindings-Anforderung, um die Liste der Bindungen einer einzelnen Dateifreigabe abzurufen. In der Anforderung werden alle Bindungen für eine Freigabe aufgelistet. Jede Bindung wird implizit erstellt, wenn eine Zugriffsberechtigtenfreigabe erstellt wird.

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

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus.

{
  "bindings": [
    {
      "accessor": {
        "crn": "crn:[...]",
        "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
        "id": "r006-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/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r006-df760133-3513-47e7-b980-26cca666561b",
      "id": "r006-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/r006-65f30e48-3074-4eb0-9ec4-51ce2ec968eb/bindings?limit=20"
  },
  "limit": 50,
  "total_count": 1
}

Bestimmte Bindung einer Dateifreigabe mit der API anzeigen

Erstellen Sie eine Anforderung GET /shares/{share_id}/bindings/{binding_id}, um die Informationen einer bestimmten Bindung einer Dateifreigabe abzurufen. Diese Anfrage ruft eine einzelne Bindung ab, die durch den Bezeichner in der URL angegeben ist.

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

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus.

{
  "accessor": {
    "crn": "crn:[...]",
    "href": "https://us-south.iaas.cloud.ibm.com/v1/shares/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339",
    "id": "r006-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/r006-f64efe74-a5a2-45c7-b37d-5071d2dd6339/bindings/r006-df760133-3513-47e7-b980-26cca666561b",
  "id": "r006-df760133-3513-47e7-b980-26cca666561b",
  "lifecycle_state": "stable",
  "name": "my-share-bind",
  "resource_type": "share_binding"
}

Alle Mountziele einer Dateifreigabe mit der API auflisten

Erstellen Sie eine Anforderung GET /shares/{share_id}/mount_targets, um alle Mountziele einer Dateifreigabe aufzulisten.

Beispiel:

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

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus:

{
  "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
}

Anzeigen eines einzelnen Mount-Ziels über die API

Erstellen Sie eine Anforderung GET /shares/{share_id}/mount_targets/{mount_target_id}, um Informationen zu einem einzelnen Mountziel einer Dateifreigabe abzurufen. Diese Anforderung schließt Mountpfadinformationen (mount_path) ein. Verwenden Sie den Mountpfad, um eine Dateifreigabe einer Instanz zuzuordnen.

Siehe das folgende Beispiel

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

Eine erfolgreiche Antwort sieht wie im folgenden Beispiel aus. In diesem Beispiel ist die Datenverschlüsselung bei der Übertragung aktiviert.

{
    "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": "ipsec",
    "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"
    }
  }

Anzeigen einer Quelldateifreigabe für eine Replikat-Dateifreigabe über die API

Erstellen Sie eine Anforderung GET /shares/{replica_id}/source und geben Sie die Replikatfreigabe-ID an, um die Details der Quellendateifreigabe abzurufen.

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

Eine erfolgreiche Antwort enthält Details zu der Quellendateifreigabe. Beachten Sie, dass die Replikationsrolle source angegeben ist.

{
    "access_control_mode": "security_group",
    "created_at": "2023-07-18T22:58:49.000Z",
    "crn": "crn:[...]",
    "encryption": "none",
    "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"
    }
  }

Anzeigen von Dateifreigaben und Einhängezielen mit Terraform

Sie können Terraform verwenden, um Informationen zu Ihrer Dateifreigabe und Ihren Mountzielen anzuzeigen.

Um Terraform zu verwenden, laden Sie die Terraform CLI herunter und konfigurieren Sie das IBM Cloud Provider Plug-in. Weitere Informationen finden Sie unter Einführung in Terraform.

VPC-Infrastrukturservices verwenden einen bestimmten regionalen Endpunkt, der standardmäßig auf us-south ausgerichtet ist. Wenn Ihre VPC in einer anderen Region erstellt wird, stellen Sie sicher, dass Sie die entsprechende Region im Providerblock in der Datei provider.tf als Ziel angeben.

Sehen Sie sich das folgende Beispiel für eine andere Region als die Standardregion us-south an.

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

Alle Dateifreigaben mit Terraform anzeigen

Importieren Sie die Liste der Dateifreigaben, die zu einem Konto gehören, als schreibgeschützte Datenquelle. Sie können nach Freigabename oder Ressourcengruppen-ID filtern.

data "ibm_is_shares" "example" {
}

Zu den exportierten Attributen gehören die Gesamtzahl der gemeinsam genutzten Ressourcen und die Liste der gemeinsam genutzten Ressourcen. Zu den verschachtelten Attributen gehören Freigabe-ID, Name, Erstellungsdatum, Größe, E/A-Operationen pro Sekunde, CRN, Zugriffstags, Verschlüsselungstyp und Schlüssel, Lebenszyklusstatus, Replikationsrolle und -status, Mountziel und weitere Attribute.

Weitere Informationen finden Sie unter ibm_is_shares.

Informationen zur Dateifreigabe mit Terraform anzeigen

Importieren Sie die Details einer Dateifreigabe als schreibgeschützte Datenquelle. Sie müssen die gemeinsam genutzte Ressource nach ID oder Name identifizieren.

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

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

Zu den exportierten Attributen gehören ID, Name, Erstellungsdatum, Größe, E/A-Operationen pro Sekunde, CRN, Zugriffstags, Verschlüsselungstyp, Verschlüsselungsschlüssel, Lebenszyklusstatus, Replikationsrolle und -status, Mountziel und weitere Attribute.

Weitere Informationen finden Sie unter ibm_is_share.

Mountziele anzeigen, die einer Dateifreigabe mit Terraform zugeordnet sind

Importieren Sie die Liste der Mountziele, die einer Dateifreigabe als schreibgeschützte Datenquelle zugeordnet sind. Identifizieren Sie die Dateifreigabe anhand ihrer ID.

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

Zu den exportierten Attributen gehören die Liste der Einhängeziele sowie deren IDs, Namen, Erstellungsdaten, Einhängepfade und Subnetz-Informationen.

Weitere Informationen finden Sie unter ibm_is_share_mount_targets.

Informationen zum Mountziel mit Terraform anzeigen

Details eines Mountziels als schreibgeschützte Datenquelle importieren. Geben Sie das Mountziel an, indem Sie die Freigabe-ID und die Mountziel-ID angeben. Beide Argumente sind erforderlich.

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

Zu den exportierten Attributen gehören ID, Name, Erstellungsdatum, Mountpfad, Teilnetzinformationen und andere Attribute.

Weitere Informationen finden Sie unter ibm_is_share_mount_target.

Nächste Schritte

Hängen Sie Ihre Dateifreigaben an. Das Mounten ist der Vorgang, bei dem das Betriebssystem eines Servers Dateien und Verzeichnisse auf dem Speichergerät für den Zugriff der Benutzer über das Dateisystem des Servers verfügbar macht. Weitere Informationen finden Sie in den folgenden Quellen:

Verwalten Sie Ihre Dateifreigaben und Daten.

  • Dateifreigaben verwalten. Sie können eine Dateifreigabe umbenennen. Sie können die Kapazität erhöhen und die E/A-Operationen pro Sekunde ändern. Sie können Mountziele zu einer Dateifreigabe hinzufügen. Sie können ein Mountziel umbenennen oder löschen. Sie können eine Dateifreigabe löschen, wenn Sie sie nicht mehr benötigen.
  • Erstellen Sie eine Dateifreigabe mit Replikation. Mit der Replikationsfunktion können Sie eine schreibgeschützte Kopie Ihrer Dateifreigabe in einer anderen Zone aufbewahren. Die Replikatfreigabe wird aus der Quellenfreigabe nach einem von Ihnen angegebenen Zeitplan aktualisiert. Die Replikation bietet eine Möglichkeit zur Wiederherstellung nach einem Vorfall am primären Standort, wenn auf Daten nicht mehr zugegriffen werden kann oder eine Anwendung fehlschlägt. Die Replikation kann auch für die geografische Erweiterung verwendet werden.