{"templateId":"markdown","sharedDataIds":{},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Utilities","description":"Accelerate E&P application development and protect your innovation by consuming our Data and Domain APIs / Platform APIs.","lang":"en-US","meta":[{"name":"robots","content":"noindex"}],"llmstxt":{"hide":true,"excludeFiles":[]}},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"utilities","__idx":0},"children":["Utilities"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A set of utilities to enable extra operations in seismic store."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generate-a-cloud-storage-access-token","__idx":1},"children":["Generate a cloud storage access token"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required Role"]},": subproject.admin, subproject.viewer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},": generate a cloud storage access token that can be used to upload/download physical objects that compose a dataset to/from a storage location"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.sdpath"]},": the seismic store subproject path."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.readonly (optional)"]},": require a readonly(true, default) or readwrite(false) access token"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# seistore app API call\n\ncurl -s -X GET \\\"https://HOST/seistore-svc/api/v3/utility/gcs-access-token?sdpath=sd://TENANT_NAME/SUBPROJECT_NAME\\\" \\\\\n    -H \\\"accept: application/json\\\" \\\\\n    -H \\\"Content-Type: application/json\\\" \\\\\n    -H \\\"Authorization: Bearer STOKEN\\\"\n\n# this api returns an empty response\n\n{\n  \\\"access_token\\\": \\\"ya29.fgdgsdngevrjbinb0ednberoibnerbnerber...........fdsfwefwe_cece\\\",\n  \\\"token_type\\\": \\\"Bearer\\\",\n  \\\"expires_in\\\": 3600\n}\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"copy-a-dataset-in-seismic-store","__idx":2},"children":["Copy a dataset in seismic store"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required Role"]},": subproject.admin"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},": copy a dataset in seismic store."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notes"]},": The copy destination can be set in a different subproject (within the same tenant)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.sdpath_from"]},": the seismic store source dataset path."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.sdpath_to"]},": the seismic store destination dataset path."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.lock(optional)"]},": lock source and destination while copying."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# seistore app API call\n\ncurl -s -X POST \\\"https://HOST/seistore-svc/api/v3/utility/cp?sdpath_from=sd://TENANT_NAME/SUBPROJECT_NAME/DATASET_PATH/DATASET_NAME&sdpath_to=sd://TENANT_NAME/SUBPROJECT_NAME/DATASET_PATH/DATASET_NAME_copy\\\" \\\\\n    -H \\\"accept: application/json\\\" \\\\\n    -H \\\"Authorization: Bearer STOKEN\\\"\n\n# API response \n\n{\n  \\\"subproject\\\": \\\"tutorial\\\",\n  \\\"gcsurl\\\": \\\"ss-p4d-eoldihs4vk7oo1yo/kmD6lvCCxBTDc3Ht\\\",\n  \\\"path\\\": \\\"/data/\\\",\n  \\\"last_modified_date\\\": \\\"Mon Jun 22 2020 13:15:21 GMT+0000 (Coordinated Universal Time)\\\",\n  \\\"created_date\\\": \\\"Mon Jun 22 2020 13:15:21 GMT+0000 (Coordinated Universal Time)\\\",\n  \\\"tenant\\\": \\\"company\\\",\n  \\\"name\\\": \\\"testdata.txt_copy\\\",\n  \\\"ltag\\\": \\\"company-public-usa-seistore-1\\\",\n  \\\"created_by\\\": \\\"testUserSeistoreViewer@company.com\\\",\n  \\\"ctag\\\": \\\"0000000000000000p4d-ddl-eu-company\\\"\n}\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generate-the-upload-connection-credentials-string","__idx":3},"children":["Generate the upload connection credentials string"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required Role"]},": subproject.admin, subproject.viewer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},": Generate the upload connection credential string for a subproject collection or a dataset, depending of the applied access policy (uniform/dataset)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notes"]},": These credentials can be used via CSP SDK, on client side, to perform bulk upload. The endpoint response is CSP (Cloud Solution Provider) dependent."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.sdpath"]},": the seismic store source dataset path."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# seistore app API call\n\ncurl -s -X GET \\\"https://HOST/seistore-svc/api/v3/utility/upload-connection-string?sdpath=sd://TENANT_NAME/SUBPROJECT_NAME\\\" \\\\\n    -H \\\"accept: application/json\\\" \\\\\n    -H \\\"Content-Type: application/json\\\" \\\\\n    -H \\\"Authorization: Bearer STOKEN\\\"\n\n# API response\n\n{\n  \\\"access_token\\\": \\\"TOKEN\\\"\n  \\\"expires_in\\\": \\\"TIME_IN_MINUTES\\\"\n  \\\"token_type\\\": \\\"TOKEN_TYPE\\\"\n}\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"generate-the-download-connection-credentials-string","__idx":4},"children":["Generate the download connection credentials string"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required Role"]},": subproject.admin, subproject.viewer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},": Generate the download connection credential string for a subproject collection or a dataset, depending of the applied access policy (uniform/dataset)"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Notes"]},": These credentials can be used via CSP SDK, on client side, to perform bulk download. The endpoint response is CSP (Cloud Solution Provider) dependent."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.sdpath"]},": the seismic store source dataset path."]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# seistore app API call\n\ncurl -s -X GET \\\"https://HOST/seistore-svc/api/v3/utility/download-connection-string?sdpath=sd://TENANT_NAME/SUBPROJECT_NAME\\\" \\\\\n    -H \\\"accept: application/json\\\" \\\\\n    -H \\\"Content-Type: application/json\\\" \\\\\n    -H \\\"Authorization: Bearer STOKEN\\\" \\\\\n    -H \\\"appkey: APP_KEY\\\"\n\n# API response\n\n{\n  \\\"access_token\\\": \\\"TOKEN\\\"\n  \\\"expires_in\\\": \\\"TIME_IN_MINUTES\\\"\n  \\\"token_type\\\": \\\"TOKEN_TYPE\\\"\n}\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"list-contents-in-a-seismic-store","__idx":5},"children":["List contents in a seismic store"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Required Role"]},": subproject.admin, subproject.viewer"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Description"]},": list tenants, subprojects, and datasets registered in seismic store"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.wmode(optional)"]},": the endpoint working mode, dirs return directories only, datasets return datasets only and not-specified(default) return both"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.limit(optional)"]},": maximum number of items to return"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Param.query.cursor"]},": the execution cursor returned from the previous call (for the list next items)"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"# seistore app API call\n\ncurl -s -X GET \\\"https://HOST/seistore-svc/api/v3/utility/ls?sdpath=sd://TENANT_NAME/SUBPROJECT_NAME&wmode=dirs\\\" \\\\\n    -H \\\"accept: application/json\\\" \\\\\n    -H \\\"Content-Type: application/json\\\" \\\\\n    -H \\\"Authorization: Bearer STOKEN\\\"\n\n# API response \n\n{\n  \\\"dirs\\\": [\n    \\\"data/\\\"\n  ]\n}\n","lang":"bash"},"children":[]}]},"headings":[{"value":"Utilities","id":"utilities","depth":1},{"value":"Generate a cloud storage access token","id":"generate-a-cloud-storage-access-token","depth":2},{"value":"Copy a dataset in seismic store","id":"copy-a-dataset-in-seismic-store","depth":2},{"value":"Generate the upload connection credentials string","id":"generate-the-upload-connection-credentials-string","depth":2},{"value":"Generate the download connection credentials string","id":"generate-the-download-connection-credentials-string","depth":2},{"value":"List contents in a seismic store","id":"list-contents-in-a-seismic-store","depth":2}],"frontmatter":{"seo":{"title":"Utilities"}},"lastModified":"2025-04-08T20:08:32.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/solutions/seismic-dms/tutorial/utilities","userData":{"isAuthenticated":false,"teams":["anonymous"]},"isPublic":true}