SDKのトラブルシューティング

• Java SDK: ステータス・コード-1でBmcExceptionがスローされます。この例外には、true値を持つタイムアウト・フィールドもあります。
• Go SDK: 返されるエラー・メッセージには"(Client.Timeout exceeded while awaiting headers)"が含まれます。
• .NET SDK: System.Threading.Tasks.TaskCanceledExceptionがスローされます。
• TypeScript SDK: エラーには"ETIMED"が含まれます。
• Ruby SDK: ステータス・コード0でNetworkErrorがスローされます。
• Python SDK: ConnectTimeout例外が"ConnectTimeoutError"を含むメッセージとともにスローされるか、RequestExceptionが"Read timed out"を含むメッセージとともにスローされます。

1. SDKを更新しましたか。
   • その場合は、コードが動作していたときに使用していた元のバージョンに戻してみてください。
     • 元のバージョンが動作する場合は、その動作しているバージョンをそのまま使用し、新しい(動作していない) SDKバージョンを使用してステップ2に進みます。
     • 元のバージョンのSDKが動作しなくなった場合は、ステップ2に進みます。
   • SDKバージョンが変更されていない場合は、最後に動作していたときから他にコードが変更されていないか確認します。
     • コードが変更されている場合は、それらの変更を元に戻して、動作していた元のコードを再試行してください。
       • 動作していた元のコードが動作しなくなった場合は、ステップ2に進みます。
       • 動作していた元のコードで問題なく動作する場合、問題が発生した原因はコードの変更です。
     • 前回動作していたときからコードが変更されていない場合は、ステップ2に進みます。
2. 同じマシンから同じリクエストを別のOCIリージョンに送信すると、タイムアウトが発生しますか。
   • そうでない場合、タイムアウトが発生した原因はサービスです。サポートに連絡し、失敗したリクエストのopc-request-idを提供できるように準備してください。
   • まだリクエストがタイムアウトで失敗する場合は、ステップ3に進みます。
3. OCI CLIやcurlなど、別のツールまたはSDKから同じ操作を試行してください。まだタイムアウトの問題が発生しますか。
   • 発生しない場合は、サポートに連絡するか、Githubで問題を作成してください。
   • 発生する場合、問題はサービスまたはネットワークに関連しています。ネットワーク接続を確認するか、サポートにお問い合せください。
4. 考えられるその他の原因:
   1. インターネット速度が構成済のタイムアウト期間内にリクエスト本文のコンテンツをすべて送信するのに十分でない場合、タイムアウト・エラーが発生することがあります。インターネット接続とタイムアウトの設定を確認してください。
   2. ローカル・ネットワークとプロキシの設定を確認して、ホスト名を解決できることを確認します。

export REQUESTS_CA_BUNDLE=path_to_cert_bundle_file

1. Apple Mac OSキーチェーンに証明書をインポートします:

   sudo security add-trusted-cert -d -r trustRoot -k "/Library/Keychains/System.keychain" ~/workspaces/trustroots/root-ca.crt

2. Java Runtime Environment (JRE)トラストストアに証明書をインポートします:

   export JAVA_HOME="$(/usr/libexec/java_home)"
                       sudo keytool -importcert -alias missioncontrol-root-ca -file ~/workspaces/trustroots/root-ca.crt -keystore $JAVA_HOME/jre/lib/security/cacerts -storepass changeit

pool := x509.NewCertPool()
            //readCertPem reads the pem files to a []byte
            pool.AppendCertsFromPEM(readCertPem())
            //install the certificates to the client
            if h, ok := client.HTTPClient.(*http.Client); ok {
            tr := &http.Transport{TLSClientConfig: &tls.Config{RootCAs:pool}}
            h.Transport = tr
            } else {
            panic("the client dispatcher is not of http.Client type. can not patch the tls config")
            }

# There are two ways of trusting certs
            
            # 1. Pass the certs directly to a client
            object_storage = oci.object_storage.ObjectStorageClient(config)
            object_storage.base_client.session.verify = 'path_to_cert_bundle_file'
            
            # 2. Set the environment variable "REQUESTS_CA_BUNDLE"
            export REQUESTS_CA_BUNDLE=path_to_cert_bundle_file

# Take identity client as an example
            # Refer to this link: https://ruby-doc.org/stdlib-2.4.1/libdoc/net/http/rdoc/Net/HTTP.html for a complete list of variables to configure
            identity = OCI::Identity::IdentityClient.new
            identity.api_client.request_option_overrides = {
            # Sets path of a CA certification file in PEM format.
            # The file can contain several CA certificates.
            :ca_file => 'PATH_TO_CA_FILE',
            # Sets path of a CA certification directory containing certifications in PEM format.
            :ca_path => 'PATH_TO_CA_DIR',
            }

export NODE_EXTRA_CA_CERTS=<path_to_cert>

[DEFAULT]
            user=ocid1.user.oc1..<example>
            fingerprint=<example fingerprint>
            key_file=~/.oci/oci_api_key.pem
            tenancy=ocid1.tenancy.oc1..<example>

• 「ユーザーに適切な構成が見つからない」のようなエラー・メッセージが表示された場合は、有効な構成ファイルがあることを確認します。
• インスタンス・プリンシパル認可またはリソース・プリンシパル認可を使用している場合は、正しい環境で実行していること、およびIMDSサービスが有効になっていることを確認します。認証方法の詳細は、SDKの認証方法を参照してください。